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1,0 INTRODUCTION 



1.0 iMiaaayaioM 



The CYBEI^ 180 Simulator Is a software devef opi^erit tool that 
provides a means of executing CYBER 180 Central Processor and 
Peripheral Processor programs prior to the availability of the 
CYBER 180 hardware. 

The Simulator executes on the NQS operating system and is 
designed primarily for interactive use? but it way be easily 
used in batch mode • Descriptions in this ERS are aimed 
Biainly at the interactive user. 



1*1 ailQ££ 

The CYBER 180 Simulator provides a simulated CY8ER 180 
hardware environment and a repertoire of commands by which the 
user can exercise control over that environment* The 
simulation that is provided is a 'pure' hardware simulation^ 
ie. no programs or software functions are provided by the 
Simul ator I tsel f • 

It is the users responsibility to provide for the creation 
of a valid CYBER 180 software environment. This means that 
the user must supply the object programs* data* etc. which 
set up the necessary process state registers* processor state 
registers* etc. for a simulation run. For example* central 
memory tables and processor state registers necessary for the 
operation of the CYBER 180 virtual addressing mechanism must 
be established by the user. Other tools or products exist - 
such as 6ENCPF* CYBIL* C180 Assembler - to aid the user in 
accomplishing this* but a description as to their use is 
beyond the scope of this document. 

A closely related product is the Simulated NOS/VE Program 
Interfaces package. This package exists as an integral part 
of the CYBER 180 Simulator* but a description of the 
capabilities and features of this product Is not included in 
this document and can found In the Simulated NOS/VE Program 
Interfaces ERS. 

The Hardware Checkout System CHCS) physical I/O simulation 
module also exists as a part of the Simulator* but a 
definition of Its function and use Is also beyond the scope of 
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1.0 INTRODUCTION 
1*1 SCOPE 



this ERS* This module Is only ysed by the HCS and NQS/VE 
projects* 

The Sifflulator executes under the control of the SES CoiBffland 
Processor i*hlch Is described In the ERS for the Cowfliand 
Processor Interface* No attempt Is made in this document to 
describe the features available under the Command Processor or 
any of its limitations* 
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2,0 APPLICABLE DOCUHENTS 



2.0 4££LICAIL£^Qfiaya£!iIi 



The foiloi^lnd documents reference related material which 
vfould be of value and interest to the Simulator user. 

NQS Version 1 Time-Sharing User's Reference Manual 

<fe0435500i 

o CDC CYBER 180 Mainframe Model-Independent General 

Design Specification (MIGDS) {ARH1700I 

o An Introduction To CYBER 180 {AO€CI 

SES User's Handbook (ARH1833) 

o ERS for Simulated NQS/VE Program Interfaces CARH3125) 

ERS for SES Virtual Envlronaent Linker (ARH2816) 

ERS for SES Virtual Envlronajent Generator CARH2591J 

ERS for SES Command Processor Interface CSESOOOl) 

o ERS for C180 Assembler (ARH1693I 

ERS for CYBER 180 PP Cross Assembler {S2501I 

o CY8IL Language Specification <ARH2298) 

o 7154/844 Disk Storage Subsystem MA401 Controlware ERS 

o 7155 Disk Storage Subsystem MA721-A Controlware ERS 

o 7155-14 Disk Storage Subsystem MA722-A Controlware ERS 
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3,0 0ESCRIPTI3M 



3.0 aiKSiEiinii 



3.1 QIIEMIiii 

The Simulator provides the user wltfi a capability to 
execute CYSER 180 CP and PP software on a simulated CY8EP 180 
hardNiare systera* The Sl^nuiator provides interpretive 
execution of CP and PP instructions and a complete set of 
commands that give the user the necessary control over the 
simulated environment. The functions and control available 
offer the user the following capabilities: 

-Central Processor- 

1« toad object programs into Central Heiaory 
2» Control the starting and stopping of Interpretive 
execution of CP instructions. Optionally display 
the results of each Instruction's execution* 

3. Set and clear CP breakpoint addresses 

4. Initiate and ternsinate instruction tracing 

5« Inspect and change the contents of central memory 
6« Dump portions of central »newory to a specified 

file 
7« Inspect and change the contents of the process 

state and the processor state registers 

8. Reifiove and add CP simulation from/to the total 
system siinulation 

9. Display stack frame information 

10. Monitor the performance or an executing program 



-Peripheral Processors- 

!• Load object programs into the Peripheral 
Processor's memory 

2. Control the starting and stopping of interpretive 
execution of PP Instructions. Optionally display 
the results of each instruction execution. 

3. Set and clear PP breakpoint addresses in each 
simulated ?P 

4* Initiate and terminate PP instruction trace 
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3.0 DESCRIPTION 

3.1 OVERVIEW 



5* Inspect and change the contents of any PP memory 
6» dump portions of anir ?^ memory to a specified 

file 
7» Inspect and change the contents of any PP 

reg ister 
3* Remove and add indlyidwal PP*s frop/to the total 

systew simulation 



•General- 



1» Checkpoint and restart the system at any point In 

the simulation session 
2# Display pertinent system Information 
3« Display the list of Simulator commands and an 

abbreviated version of the syntax of each command 
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III £2I*£^2I5 i2£«H*!il2E£-^ 

3.0 DESCRIPTION 

3,2 uauL4i£i-caM£isysiiioM 

Tlie definition of the hardware that Is slmyfated by the 
CYBER 180 Simulator Is contained in the CYBER 180 Halnfrawe 
Hodel-Independent General Design Specification (MIGDSI and In 
the appropriate disk storage suhsysteiu control ware ERS«s« 

The current simulated hardware configuration consists of 
the following co^ponentss 

o Centra! Processor CP2I 

Central Hei»ory - 16#777f216 bytes <decifflan 

o Input / Output Unit (IQUI 

o 10 Peripheral Processors (PPs numbered •* 

9C10)I 
12 bi-dlrectlonal I/O channels Cnumbered •• 
13C8H 
o 2 7154 disk controllers sharing 4 844-4x disk storage 

unl ts Idsusl 
2 7155-1 disk controllers sharing 2 844-4x dsus and 2 

885-lx dsus 
o 2 7155-14 disk controllers sharing 2 844-4 x dsusf 2 
885-lx dsus and 2 885-42 dsus 

Each P? includes 4096 words of 16 bit wefsory* Each I/O 
channel (not connected to a disk controller) is a 16 bit 
bi-directional channel which (Bay be used by any PP to 
communicate with any other PP« 

The two 7154 disk controllers are on I/O channels 2 and 3* 
A 12 bit external Interface Is sifflulated for these channels. 
The four shared 844-4x dsus correspond to unit numbers 0#1*2 
and 3* 

The two 7155-1 disk controllers are on I/O channels 4 and 
5» which are also 12 bit channels* The two shared 844-4x dsus 
correspond to unit numbers and 1» The two shared 885-lx 
dsus are unit numbers 40 and 41 Coctal). 

The two 7155-14 disk controllers are on I/O channels 6 and 
7 which are full 16 bit channels* The two shared 844-4x dsus 
correspond to unit numbers and 1« The two shared 885-lx 
dsus and the two shared 885-42 dsus correspond to unit numbers 
40#41f42 and 43 (octal)» respectively. 

CP and lOU (PPs) Instruction simulation Is controled via 
the ONf OFF and RUNf RUN.PP commands* The ONf OFF commands 
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3.0 DESCRIPTION 

3.2 SIMULATED CONFIGURATION 



are used to add or reiJtove a particular processor froiii 
instruction simulation. A processor must be aa to be Included 
In instruction sifnulatlon. In i 1 1 al ly^ the default states of 
the processors ares CP qq and all PPs af£» 

The RUN and RUN.PP cofflflsands initiate Instruction simulation 
in the CP of PPs# respectively. Instructions are siinulated in 
all PPs that are aa in a manner comparable to the hardware 
"barrel and slot** mechanisffl. 

During instruction sisulatlonf control asay be passed back 
and forth between the CP and the P^ processors by jneans of 
specially defined ••escape'* instructions (see section on 
Special Instruction Processing). A CP escape instruction 
Iffliiiedi atel y initiates ?P instruction simulation for all ??s in 
an aa state* likewise* an escape Instruction encountered 
during PP instruction slifiulation I (nmed iatei y begins Cor 
resumes) CP instruction simulation. 
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3*0 DESCRIPTION 

3.3 aiLLiiia«ia£-Sit!yL4ias 

The SES procedure SIM180 is used to invoke the CY8ER 180 
Slisul ator « 

SIH180 sets up the total system simulated environiaent and 
gives control to the Cyber 180 Sii^ufator* At this point* the 
user isay enter any valid Simulator comffland* The environment 
that is established is determined by the restart parameter and 
Is either an Initial •e»pty» system or a previously 
checkpointed system* 

The Cyber 180 Simulator Is Intended pr iisarily for 
interactive use C local model but may be readily used in 
batch* An example of batch submittal of a Simulator run is 
given belott* Parameters to SIM180 are? 

restart or rs s 

(optional} name of a checkpoint file from *«hlch to 

restart simulation* The checkpoint file may be one 
previously created by GENCPF C££ierate C^eckgoint 

£iler» VEGEN (Virtual Environment SEMeratorl or the 

Simulator Checkpoint command* If you don't code the 

parameter* then a complete simulated system 
environment will be created* 



cf 



(optional) name of a command file which is to be 
processed immediately upon activation of the 
Simulator* The command file consists of one or more 
valid Simulator command(s)* This parameter is 
re<iulred when running In batch* 



1180 or I : 

(optionail name of the file nhlch contains input for 
the special Simulator CPU I/O Instruction (op code 
FF(16H« If you're running SIM180 interactively and 
don't code the 1180 parameter* SIM180 takes Its Input 
from your terminal* If you run SIM180 in batch and 
use the CPU I/O instruction for input* you must 
supply a file containing the input* See section on 
Special Instruction Processing for more information* 



ol80 or o 
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3»0 DESCRIPTION 

Copt ion an naiae of the file nhich Is to receive 
output froiP the speclai Simulator I/Q instruction (op 
code FF>* If you're running SIM180 interactively and 
don't code the ol80 parameter* SIM180 sends output to 
your terfliinal. If you run SIH180 in batch you ruust 
supply a file to reel eve the outputf other nlse it is 
lost. See section on Special Instruction Processing 
for more information. 



Examples of SIN180 Usage 

♦♦ I SM 60521 CYBER 180 SIHULATOR V6.5 LEV 127 CHISOS REV SI I 

This example shows SIH180 used interactively to create a 
new simulated systeis environment. The user may enter any 
Simulator command once the Simulator banner is displayed* 

ses*siflil80 rs«eheckl cf«errata \ 

♦♦ I SH 60521 CYBER 180 SIMULATOR V6.5 LEV 127 IHI60S REV SI J 

This example shows SIMISO used to resume simulation from a 
checkpoint file. The command file errata will be processed 
before requesting additional Simulator commands from the 
user. 



ses«siiiil80 checkx i»indata o^outdata 

♦* I SN 60528 CYBER 180 SIMULATOR V6.5 LEV 127 (MI60S REV SI 

This example shows SIM180 used interactively to resume 
simulation from the checkpoint file checkx. The special 
Simulator CPU I/O instruction* when encountered during CPU 
instruction simuiationf is to read input from file indata and 
is to write output to file outdata. 



ses.do batchn file»sincf cs*(«. 

• •t *ses.sliil80 postds cf^slmcf o*progout*9.. 

••? *save»seslog*l 

15«5^.28. AAAQCBN 
REVERT. JOB DO SUBMITTED 
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3.0 DESCRIPTION 

3.3 CALLING THE SIMULATOR 

TNis exafl^pte shows SIHISO submitted for batch executlori via 
the SES.OQ procedure. Simulation resumes from the checkpoint 
file postdsf the Sinsutatof cousfliands in the file siiRcf are 
processed* and any output froii the special Sisnulator CPU I/O 
instruction is directed to file progout. 



CQHPANY PRIVATE 



COC ADVANCED SYSTEMS DEVEIQPHENT 
ERS for CYBER 180 SiiuJatof 



3-8 
15 Dec 81 



3»0 DESCRIPTION 

3,4 RESOURCE REQUIREMENTS / PERFORMANCE CONSIDERATIONS 



3 . 4 a£Sayi(I£.££iy iE£!i£{iIl«iL.££££Q£ll^li££^CQMiIQ£EAIil3lii 

The Simulator executes on the NOS operating systeiw and 
requires a winlsiuii of 150»000B words of CMt and optionally 
uses up to lOOfOOOB words of ECS If available* Usage of ECS 
is discussed be ion* 

Several performance factors were taken into account in the 
design of the Simulator. It is to the advantage of the user 
to have some understanding of these In order to take full 
advantage of them and thereby keep job overhead and 
developfiient center overhead to a inlnljauro* The following 
performance discussion applies exclusively to the CP and 9P 
Instruction simulation initiated by the RUN or the RUN.PP 
commands* Performance considerations of the remaining 
Simulator commands are negligible in comparison* 

As previously stated» instruction simulation may transfer 
back and forth between the CP and the lOU CPPsl under control 
of specially defined ••escape** instructions* Each transfer 
represents one primary level overlay load* 

The Simulator is designed so that primary level overlay 
loading Is only done when transferring between CP and PP 
Instruction simulation* Secondary level of overlaying is done 
if a particular feature is being utilized* For example* on 
the CP side of simulation* the Simulated NOS/VE I/O package is 
loaded if It is used* The same is true of the Simulated 
NOS/VE Program Hanagement interfaces and the HCS I/O package* 
These are only loaded when called* On the IQU side* disk 
simulation is loaded at a secondary level when It is 
required* 

The overlays are loaded either from an absolute file or 
from ECS» if It is available and if the user is validated for 
ECS access* 

The following recommendations should be considered by each 
user when running simulations: 

1* All users should be validated for a CH field length 
which exceeds the minimum requirement of 150*0008* A 
value of 230*0008 is recommended* This Is sufficient 
to obtain maximum performance on large simulation runs 
eg* NOS/VE OS simulations* Actual CN used will be 
less for smaller simulation runs* 

2* All users should be validated for 200*0008 ECS* This 
should be considered a requirement for any user 
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3 E SC R I P T I Q H 

3,4 RESOURCE REQUIREHENTS / PERFORHAHCE CONSIDERATIONS 



running tti« Simulator* The Slisutator uses ECS for 
overfay loading when it Is avallablet but Miti load 
from disk if It Is not* Perforwance of certain 
Sliaulator runs and developwent center system I/O 
overhead win be adversely effected If ECS Is not 
available* 
3* Unused PPs should be In an 2££ state to prevent 
unnecessary Instructions from being simulated* 



The on/off status of the Individual processors can be 
inspected via the display.info coi^mand* 
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3«0 DESCRIPTION 

Files created by the Simulator are described Nere In in 
order to acquaint the user with their nawes and usage* A 
general rule to follow to avoid file naming conflicts is to 
refrain from using any file nawes starting with the three 
letters *S£S*« Any «an ipul at i on of the Simulator files during 
a simulation session such as rewinding or returning will 
produce unpredictable results* 

The following files exist normal I y» when applicable^ as 
local files following a Sfimuiator session* 

iiiLQS* This file is a I eg lb I e f i I e that contains a 
co!nplete log of the siaiulation session* Included Is all 
coismand input and all output resulting from the 
coBifliands* This file may be printed via the SES* I^RINT 
uti I i ty* 

iEiifiilE* This is a legible file that has all the trace 
output froB! traced CP and traced PR Instructions* The 
trace output is In chronological order so CP and PP 
output Biay be interspersed* This file ^ay be printed via 
the SES* PRINT uti lity* 

S£SS!S11£« This file contains the output from CP keypoint 
instruction simulation* The file Is a collection of 
binary keypoint records* and Is not In a form to be 
printed* The format of the keypoint file records Is 
explained in the following section on Special Instruction 
Processing* 

S£Siti^Q« This represents four possible files where q« 
0fl»2 or 3* These files contain the data for the four 
simulated 844-4x dsus shared by the the 7154 controllers* 
unit numbers 0»1»2 and 3* These files are only created 
if read from or written to# and only if they don't 
already exist as a local file* 

^EiSSilQ* This represents four possible files where q« 
0»1»2 or 3* These files contain the data for the four 
dsus shared by the 7155-1 controllers* The files 
correspond to the two simulated 844-4x dsus and 1* and 
the two simulated 885-lx dsus 40 and 41* respectively* 
They are created In the same manner as described above 
for SESSHOn* 

i£SSSia« This represents six possible files where q« 
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3.0 DESCRIPTIQM 
3.5 SIHUIATQR FliES 



0#lf2»3f4 or 5. These files corvtain the data for the six 
dsus shared by the 7155-14 controllers. The files 
correspond to the two simulated 844-4x dsus and i» the 
two 8S5-1X dsus 40 and 41# and the two 885-42 dsus 42 and 
43* respectively. They are created In the sa^e wanner as 
described above for SESSHOn. 
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3,0 DESCRIPTION 

3,6 SIMULATOR STATUS INFORHATIOH 



3 . 6 SIiaUL4iaR.JiIAiyS.Iti£QE£iAIiQi 

Simylator users can obtain current status information on the 
siBiutator by entering SES*STATUS«$IH180« Infomation 
pertaining to changes and oiajor problems is listed in reverse 
chronological order* 
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3.0 DESCRIPTION 

3.7 SINULATOR COHHANOS 



3 . 7 iiaULiliE^CQBMiiMQi 

The user of the CYBER 180 Sfisylator controls and 
manipulates the slitulated hardware environment via the 
indlyiduai coisfwands* The cowhands all generally follow the 
syntactical ryles of the CYBER 160 System Cofflroand language 
CSCil as described In the SES Users Handbook. 

A general na«lng convention Is followed for Simulator 
cofflwands - each has a long descriptive naiae and a short naiae 
or 'atlas' foriied from the first letter of each word of the 
long narae. This is true for all coaiaands except restart and a 
couple that have no alias* The help coiBwand is available to 
aid the user In coffiwand usage. 

Simulator cowfflands may be entered at any time after SIH180 
has been entered* the Simulator banner has been displayed and 
the prompt soliciting Input is received. For exainplet 

SES.SIM180 

♦♦ I SH 6052S CYBER 180 SIHULATOR V6.5 LEV 127 (HIGDS REV SI 

Any Simulator cofRwand »ay now be entered. Refer to 
Appendix A for examples of typical Simulator sessions. A 
Simulator session Is terminated by a bye or end connsand. 

C4UII0^« ^se of the lAF user break 2 sequence to terminate 
output frofB or execution of a Simulator cowmand way 
occasionally cause an immediate exit from the SIH180 
procedure* The user break 1 sequence should always be used 
for these purposes. 

NQS commands may also be entered at any time during a 
simulation session. This Is accomplished by simply enclosing 
the command in single quotes. For example? 

Examples: 

«get»simcf • 

•cat I ist*fn«ckpf lle#lo«f« 

'ses.rewrlte l*filea o»filepm' 

CAUIIQti' l^se of the lAF user break 2 sequence to terminate 
output from or execution of a program submitted to NOS In this 
manner may cause an immediate exit from the SIM180 procedure. 

The following sections describe in detail all of the 
commands available to the CYBER 180 Simulator user. Examples 
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3.0 DESCRIPTION 

of usage of each comwand are also given* 
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3.0 DESCRIPTION 
3.7.1 BREAKPOINT I B 



3.7.1 BREAKPOINT I B 



The purpose of the BREAKPOINT comm^n^ is to establish a 
breakpoint at a specified address in the simyiated CPU. 
Execution of the instruction at the breakpoint address causes 
the stmuiatlon to halt at that point. An appropriate 
informative diagnostic is Issued which specifies the address 
of the breakpoint. 



breakpoint address«<pvi> 

Cfre<iuency«<<l>f:..<j>lC»<k>1l3 
£excliang€»<exchange.des I gnator>1 

address » a* This paraaieter specifies the process virtual 
address (PVA) for the CPU breakpoint. Ring numbers 
need not be entered as part of the PVA* They btb 
ignored If entered and Ignored when testing for a 
breakpoint address match. 

fre<iuency I ft This paraweter specifies the frequency 
conditions which mast be satisfied in order for the 
breakpoint to be honored. The frequency may be 
specified in one of three foritss 

1. f« I This form will set a CPU breakpoint which 

will be honored when the specified address Is 
encountered on the i th time and never 
thereafter. 

2. f« i*.j This form will breakpoint on the I th 

time the address Is encountered and every time 
thereafter until the jth time. 

3. f« CI..J>k) This form will breakpoint on the Ith 

time the address Is encountered and every kth 
time thereafter until the jth time is reached 
or exceeded. 

Default. If the frequency parameter Is not 
specified on the commands then the CPU breakpoint 
wilt be honored each time It Is encountered. 

exchange * exc* This parameter specifies an exchange 
package which Is to be used to "qualify" the address 
parameter. Values accepted for this parameter are: 
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!• exc* JOB This valye indicates that the 
breakpoint address applies only to any JOB 
exchange package* 

2« exc* HONITOR * HON This value indicates that the 
breakpoint address applies only to any MONITOR 
exchange package* 

3* exc* UNQUAl J UNQ This value is only ysed to 
override any excfiange parameter <iual i f icat ion 
in effect due to a previous QUALIFY.REFERENCE 
coifnand* When UNQUAL Is specifiedf any 
previous exchange package paratseter 
<luaM f icati on is overridden^ and the breakpoint 
address will apply to any exchange package - 
JOS or HOHITOR. 

4* exc» <address> The real memory id4ress CRMAI of 

an exchange package inay be specified to 

designate a particular exchange package to be 
used to <iualify the breakpoint address* 

Default* If the exchange paraweter is not entered 
for the command but there is a current exchange 
paraiReter qualification due to a previous 
qua! if y.refer ence cofBmandf then that value Is used 
and interpreted exactly as described above* 
Othemiset there is no qualification and the 
breakpoint address will apply to any exchange 
package - JOS or MONITOR. 

Examples? 

breakpoint address«1000004911t 16 ) f«l exchange* Job 
breakpoint a«3aab(16l frequency»<l* *10# 2) 
b 2300009200(16) exchange«job 
b 0b02300008765a6l f«10..15 
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3*0 DESCRIPTION 
3,7,2 BYE t END 

3»7,2 BYE J END 

Ttie BYE comi^and tenninates a sipytation session and returns 
control to the NOS operating systeja. 

bye 
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3.0 DESCRIPTION 

3.7«3 CHANGE. HEHQRY J CH 

The purpose of the CHANSE^HEHQRY command is to modify the 
contents of a field of sl<Bulated central memory* 

change.Bieaory f i r st.byte.address=<pva or r'^a> 
Cbyte«count«<count>3 
Crepeat.count*<count>3 
wemor y.va I ye-<va I ue> 

Cexchan9e»<exchange_designator>3 
Caddress.mode«<iiiode.des lgnator>3 

f Irst.byte.addf ess * fbas This paraipeter specifies the 
starting byte address of the the mewory field that 
is to be changed* It is interpreted as a PVA or RHA 
according to the address. mode parameter. Ring 
numbers are optional and ignored if entered as part 
of a PVA* 

byte.coufit I bcs This parameter specifies the length In 
bytes of the field in CPU jaeaory that is to be 
modified* The mepory value entered is right 
Justified In this field. The valid range of values 
for this parameter is 1**8* 

Default* If no value is entered then a byte count 
field length of eight (8) is assumed* 

repeat.count « res This parameter specifies the number of 
times that the memory value Is to be stored in 
successive fields - as defined by the byte. count 
parameter - In simulated CPU memory* The valid 
range of values for this parameter is l.*n* 

Default* If no value Is entered for this parameter* 
than the assumed value Is one 111* 

Memory. value * mwt This parameter specifies the value to 
be stored into the field lor fields) defined by the 
byte. count and starting at f I rst. byte. address* 
repeated by repeat. count number of times* The 
memory value given by this is right justified into 
the defined field as it is stored into CPU memory* 

exchange * exc? This parameter specifies the 'frame of 
reference' for the command* ie* it specifies to 
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3.0 DESCRIPTION 

3.7«3 CHANGE. MEMORY t CH 

which exchange package this commzn6 applies or which 
exchange package is to he used for virtual address 
translation. Values accepted for this parasieter 
ares 

1* exc* JOB This value sets the frame of reference 
for this cofRfliand to be the current Job exchange 
package as located by the contents of the 4ob 
Process State CJPSI register. 

2. exc« MONITOR ! MON This value sets the frame of 

reference for this coaiiwand to be the current 
monitor exchange package as located by the 
contents of the Monitor Process State IMPS) 
regl ster . 

3. exc» UNQUAt * UNQ This value Is used to override 

any exchange parameter <iua 1 1 f i cati on In effect 
due to a previous QUAIIFY^REFERENCE comaiand. 
When UNQUAL is given* the frame of reference 
for this command is the exchange package of the 
current iBode as determined by the node bit in 
the Status Sumwary CSS) register. If the 
current CPU mode is monitor* then the frame of 
reference is the monitor exchange package 
pointed to by the MPS. If the current mode is 
job f the exchange package pointed to by the 
JPS is the frame of reference. 

^. exc» <address> The real memory address (RMA) of 

an exchange package may be specified to 

designate that exchange package as the frame of 
reference for this command. 

Default. If the exchange parameter is not entered 
for the command* then the frame of reference for the 
command Is determined in one of tv#o *<ayss 

<1) If a previous qua! I f y_r ef erence command had 
qualified the exchange parameter for subsequent 
commandsf then that value Is used as the frame 
of reference for this command. 

(2) If the exchange parameter was not 
previously qualified by QUALIFY.REFEREMCEf then 
the frame of reference Is determined from the 
current mode In the Status Summary <SS) 
register and Its corresponding process state 
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3.7*3 CHANGE. HEMORY \ CM 



register - HPS or JPS. 

address.iROde I a«« This paraaieter dictates how the 
flrst.byte. address parameter is to be interpreted - 
whether as a process virtyal address <PVA) or as a 
real memory address (RMAI* Accepted values for this 

par a^eter are J 

1. da* PVA This value indicates virtual addressing 

mode. 

2. am* RHA This value Indicates real memory 

addressing fiiode. 

Default* If this parameter Is not specified then 
the mode used is the value established by a previous 
QUAtlFY. REFERENCE coiw^and. If no address f»ode had 
been established by a QUALIFY.REFERENCE comniandf 
then RMA is assumed. 

Exampl ess 

change. weaiory firs t. byte. address»3b00<i6) ^eroor y.val ue«0 

change. jneaiory fba«200(16l byte.count«4 repeat. count«8 ffiv«4 

ciB fba«900002b00(16) mv«888844442222C16) aai^pva 

cm 801300010010(16) bc«6 rc = 100 mv«0fff(16) exc«job aJii«pva 

cm lff<16) 1 8 0fC16) a»«rma 

cm 100000302(16) rc*8 mv=0f f f f ff f f f f f f f f f f (16) 
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3.0 DESCRIPTION 

3«7,^ CHANGE.PP^MEHORY J CPH 

The purpose of the CHAM6E«I»P_MEHQRY cowwand Is to wodlfy 
the contents of simulated PP meaory of a specified ??• 

change. pp. wewory Cpp.nu«iber«<pp.nurober > 1 

f Irst.MOfd. address *<pp^ address > 
weaory.val ye«<val ue> 
trepeat.coufit=<count>1 

PP.nunber * ppi This parameter specifies the number of 
the PP to nhich this cowmand applies* The P? mny be 
In either an *on^ or •off* state* 

Default* The pp.nunber parameter Is optional only 

if there Is a currently active <iualified P? number 

*«hich was set up by a previous QUALIFY.REFERENCE 
cominand* 

first. Hord.address * fitas This parameter specifies the PP 
address of the wewory word to be changed* or If the 
repeat. count exceeds one Cll» than It Is address of 
the first PP meiaory Hord to be changed* 

nenory. value * nivs This paraiaeter gives the value which 
is to be stored into the specified PP^s fiiemory 
starting at first. word. address for repeat. count 
nua?ber of words* The valid range of values for this 
parameter is 0**0f f f f C 161 • 

repeat. count * res This parameter specifies the number of 
tiwes that the meinory. value is to be stored into 
successive PP mejiiory locations starting at 
f Irst.wof d.address. 

Default* If no value is entered for this parameter^ 
then a value of one (1) is assumed* 

ExampI esi 

change. pp. memory pp«6 f I r st.word.addr ess«7700( 8) mv*4 

change. pp.memory pp. number^O fHa*101(8) mv^O rc=400 

cpm 9 7776(81 mv»0ffffM6) rc«2 

cpm**0#0# 2000(8) 

cpm ,#1315(8) 622A(8) 



COMPANY PRIVATE 



3-22 
CDC ADVANCED SYSTEHS OEVEIOPHENT 

15 Dec 81 

3.0 DESCRIPTION 

3«7.5 CHANGE. PP.REGISTER J CPR 

The purpose of the CHANSE^PP.RESISTER coiBwand is to change 
the contents of sifnuiated ?P registers in a specified ?Pm 

cfiange.pp.r agister Cpp. number »<pp.ny«Bber>1 

regs«<pp.r egi ster.na!iie> 
vals«<register_yaf«e> 

PP. number * pp? This paraaieter specifies the nurober of 
the PP to which this cowuiand applies* The PP ?«ay be 
In either an «on» or »off» state* 

Default* The pp. number parameter is optional only 
If there Is a currently active qualified PP number 
^hich »<as set up toy a previous QUALIFY.REFERENCE 
command* 

regs This parameter specifies the nameCsl of the PP 
register which is to be changed* Valid names for 
this parameter are Af P or R* These may be quoted 
in any combination or order* 

vals This parameter specifies the value which Is to 
placed Into the PP registerCs) specified by the regs 
parameter* There must be a one to one 
correspondence between the values given by vals and 
the register names specified by the regs parameter* 

ExampI ess 

change. pp.regi ster pp. number«8 r€gs«p vals*2205(8) 

change. pp.regi ster pp*4 a 777(81 

cpr 4 regs«(a>P>r) vals« (2512< 8)*7700<8) #0) 

cpr <a>p) {7777<8), 101(8)) 

cpr ffP 2011(8) 
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3.0 DESCRIPTION 

3.7.6 CHAHGE. REGISTER I CR 



3.7.6 CHANGE.REGISTER J CR 



The purpose of the CHAH6E.REGISTER cowi»ar»d is to change the 
contents of a simul^te4 CPU Processor State or Process State 
Cexchange packagel register. Parameters are processed and 
changes wade to the registers In the order given belOM Cle* 
an S-register change will fee J^ade i^gfatfi an A or X register 
changel* 



change.reglster Csregs«<stat€.regi ster.naroe>3 

Csvals«<state.register_yalue>3 
C ar egs« < a_r eg i s t er _nu wb e r > 3 
Cavals«<a.reglster.value>1 
Cxregs»<x^r egi ster_nyB!ber>3 
CKvals«<x^regl ster.value>3 
Ctos«<top.of_stack.register_nuBiber>3 
Ctvals«<tos«regl ster^value>3 
Cexchange*<exchange_designator>3 

sregs • SJ This parameter specifies «hich named Processor 
State register or Process State register is to be 
changed. Valid na»es for this parameter areJ 

8C I CFf S DEC J 01 I DIP I OH t £10 I FRC J JPS 
KCN t KC S KEF S KH J LPI 1 LRN 5 HCR J HDF ; HDH 
HH i HPS J OCF S 01 J PfS I PIO t PIT I P 1 PNO 
PSM 5 PTA t PTL 5 PTM I SIT S SS S STA t STL J TE 
TP ? UCR 5 UM S UP 5 UVHID S VHCL 5 VMID 

svais * SV3 This parameter specifies the value «hlch Is 
to be placed Into the corresponding named state 
register as given by the SREGS parameter. There 
3iust be a one to one correspondence between the the 
register names specified by the SREGS parameter and 
the values given for the SVALS parajneter. A value 
quoted here must fit in the register for which it is 
i ntended. 

aregs J as This parameter specifies the number of the 
A-register to be changed. Multiple A-registers 
and/or ranges may be requested to be displayed. The 
limit is five 15) A-registers or ranges per 
command. 

avals 1 av? This parameter specifies the value which is 
to be placed into the corresponding A-reglster as 
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3.0 DESCRIPTION 

3«7.6 CHANGB.REGISTER I CR 



given by the ARESS paraeeter* There must be a one 
to one correspondence between the the register nawes 
specified by the AREGS parameter and the values 
given for the AVAIS parameter. A value quoted here 
fiust fit In the register for *ihlch it is intended* 

xregs I x5 This parameter specifies the nuwber of the 
X-reglster to be changed. Hultlple X-reglsters 
and/or ranges may be requested to be displayed. The 
limit is five C5) X-registers or ranges per 
cofflffiand. 

xvals I xv5 This parameter specifies the value which Is 
to be placed Into the corresponding X-register as 
given by the XREGS para^neter. There must be a one 
to one correspondence between the the register names 
specified by the XREGS parameter and the values 
given for the XVAtS parameter. 

tos * tJ This parameter specifies the number of the TOS 
register to be changed. Multiple TOS registers 
and/or ranges may be requested to be displayed. The 
limit Is five <5) TOS registers or ranges per 

command. 

tvals * tvs This parameter specifies the value which is 
to be placed into the corresponding TOS register as 
given by the TOS parameter. There must be a one to 
one correspondence between the the register names 
specified by the TOS parameter and the values given 
for the TVAIS parameter. A value quoted here must 
fit in the register for which It Is intended. 

exchange * excJ This parameter specifies the »frame of 
reference* for the commandt le. It specifies to 
which exchange package this command applies or which 
exchange package Is to be used for virtual address 
translation. Values accepted for this parameter 
ares 

!• exc* JOS This value sets the frame of reference 
for this command to be the current job exchange 
package as located by the contents of the Job 
Process State (JPSI register. 

2. €xc« MONITOR "HON This value sets the frame of 
reference for this command to be the current 
monitor exchange package as located by the 
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3.0 DESCRIPTION 

3,7.6 CHANGE. REGISTER 5 CR 



contents of the Monitor Process State iMPS) 
register • 

3» exc* UNQUAl ? UNQ This value is used to overrltile 
any exchange par aweter qua! If I cat I on In effect 
due to a previous QUALIFY.REFERENCE command, 
Mhen UNGUAL Is given# the frame of reference 
for this command is the exchange package of the 
current jaode as dcterfiilned by the inode bit In 
the Status Summary CSSI register* If the 
current CPU mode is monitor* then the frame of 
reference is the monitor exchange package 
pointed to by the H9Sm If the current mode Is 
job ♦ the exchange package pointed to by the 
JPS Is the frame of reference. 

4. exc« <address> The real memory address (RHAI of 

an exchange package may be specified to 

designate that exchange package as the frame of 
reference for this command. 

Default. If the exchange parameter is not entered 
for the command* then the frame of reference for the 
command Is determined In one of two wayss 

<ll If a previous quai If y. reference command had 
qualified the exchange parameter for subsequent 
commandSf then that value Is used as the frame 
of reference for this command. 

(2) If the exchange parameter Mas not 
previously qualified by QUAtlFY.REFEREMCEf then 
the frame of reference Is determined from the 
current mode In the Status Summary CSSI 
register and Its corresponding process state 
register - MPS or JPS. 

Ex amp I es : 

change^regl ster sregs«ucr svals^O exchange«job 
change. regl ster s« Cucr* mcr* te) sv-(0»0»2) 
cr a*(0#3) av*C800000004010(16l»Ob00000004040<16H 
cr x*8..b xv«t512f 0f3bU6),0ff ffffffffffffe€{16)>256l 
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3,0 DESCRIPTION 
3/7,7 CHECKPOINT I C 



3.7.7 CHECKPOINT I C 



The purpose of the CHECKPOINT cowi^and Is to save the 
C03!iplete siiaulation environment on to the specified file* 
This Includes the complete central pewory and all configured 
?P jjjemorlesf all CPU process and processor state registers^ 
all PP registers* all PP channel i nf orisat Ion and ail internal 
Simulator control tables and Information* 

The checkpoint facility allows the user to checkpoint to a 
file at any point during a simulation run and to use the file 
as a restart file on a subsequent sifAulatlon run* This file 
f»ay be specified for the restart command or the restart 
parafseter on the SIH180 procedure. The environment and 
conditions will be reestablished exactly as they were at the 
checkpoint tiwe* 

The checkpoint file may be used as input to the QeadStart Q 
ump Interpreter CDSDII. 



checkpoint f i fe.naiie«<f I le_nape> 

flle^naiie * fns This oarasieter specifies the name of the 
file on which the checkpoint file Is to be written. 

Examples: 

checkpoint f i I e^name«cpf i le 
checkpoint fn«ckpl 
c cpf i le 
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3.0 OESCRIPTIOI^ 

3.7.8 CLOSE. LOGICAl^FILE I CIF 

The purpose of the CLOSE.LOSICAI.FIIE cossfisand Is to 
iogicaily close a Simulated NOS/VE I/O fife which had been 
left in ^n open state from a logical I/Q simulation. Refer to 
the Simulated NOS/VE Program Interfaces ERS for a complete 
description of this function and other logical I/O siiRulation 
features. 

close.loglcal.fi le Cf II e.naiie»<pl>1 

flle.na»e * fns This parameter specifies the name of the 
file Mhich Is to be logical iy cl osed. Up to five 
C5) file names isiay be quoted for this paraiaeter. 

Default. If this parameter is not guoted on the 
comiand* then all simulated NOS/VE I/O files will be 
logically closed. 

Exampless 

close.logicai .f i I e f 1 1 e.name«datai n 

close. logical. f I le f n*Cdatainf dataout ) 

elf twltty 

elf {f illff il2f f II 3»fi I4#f il5l 

elf 
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3,0 OESCRIPTIQH 

3.7«9 2JSPLAY.|XCHANGEj.lPACKAGE^£^D£P^^^^^^ 

3*7.9 DISPLAY^EXCMAMGE. PACKAGE J DEP 

The purpose of the DISPLAY^EXCHANGE. PACKAGE comaand is to 
display the contents of a selected exchange package* The 
contents of all registers coiHprlsing the exchange package are 
displayed except for the A* Xf and Top Of Stack CTOS) 
registers* 

displ ay.excliange.package Cexchangea<exchange_desl gnator>1 

exchange J exc? This parameter specifies the •frame of 
reference* for the coismandf le* It specifies to 
Mhich exchange package this command applies or Mhich 
exchange package is to be used for virtual address 
translation* Values accepted for this parameter 
ares 

1* exc* JOB This value sets the frafse of reference 
for this cosiwand to be the current job exchange 
package as located by the contents of the job 
Process State (JPS) register* 

2* exc« MONITOR ! MON This value sets the fraaie of 
reference for this co^wand to be the current 
monitor exchange package as located by the 
contents of the Monitor Process State CMPS) 
register* 

3* exc« UNQUAl J UNQ This value is used to override 
any exchange parameter qualification In effect 
due to a previous QUALIFY^REFERENCE cofsmand* 
When UMQUAL is glven# the frame of reference 
for this command is the exchange package of the 
current mode as determined by the mode bit In 
the Status Summary <SS) register. If the 
current CPU mode is monitor^ then the frame of 
reference Is the monitor exchange package 
pointed to by the MPS. If the current mode Is 
job f the exchange package pointed to by the 
JPS Is the frame of reference. 

^* exc* <address> The real memory address IRMA) of 

an exchange package may be specified to 

designate that exchange package as the frame of 
reference for this command* 
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3,7.9 OISPLAY.EXCHANGE.PACKAGE ? DEP 



Default* If the exchange paraBieter Is not entered 
for tlie copwandf then the frai^e of reference for the 
coiBwand is determined in one of ti*o nays: 

(1) If a previous qyal If y.ref erence command had 
qualified the exchange parameter for subsequent 
coffifflandSf then that value Is used as the frame 
of reference for this cojnuiand* 

(2) If the exchange parameter *tas not 
previously qualified by QUAtlFY.REFERENCEf then 
the fra!»e of reference Is determined from the 
current mode in the Status Summary (SS> 
register and Its corresponding process state 
register - MPS or JPS* 

Examples? 

dl spl ay.exchange^package exchange*mon i tor 
d e p J b 

Sample output? 

displ ay.ex Chan ge.pack age exc» job 

UCR»0000 

UH«FEOO 

UVMID= 

tPID'OG 

DI«00 

LRN* F 

KCN= 

OCF« 

BC*0000 



P«0000 


300E 


0000 


823C 


MCR»0000 


MDW^OOOO 


0000 


0000 


0000 


MM-FFFC 


UTP«0017 


0000 


0000 




V«IO« 


TP«2006 


0000 


0000 




TE« 2 


DLP»0000 


0000 


0000 




DI1«00 


STA-0001 


2FA0 






$TL«0023 


KC*OGOO 


0000 






KM«FFFF 


PIT-7FFF 


FC57 






CFF« 


KEF« 








PND* 


MDF»0000 
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3.0 DESCRIPTION 

3. 7*10 DISPLAY. INFO ? DI 



3»7.10 DISPLAY^INFQ J DI 



The purpose of the OISPLAY.IHFO CQmmznd Is to display 
certain pertinent information about the current state of the 
siniui atl on* The information displayed includes? 



!• 



2* 

3« 

A. 
5, 



es tab! I Shed 
wode 



by 



qual 1 f y.ref erence 



Qual if lers 
comfliands 
address 

exchange 

PP number 

file nane 

dbug file 
Incremental and total 
IQU from previous run 
Incremental and total 
tilling is on) 

CPU and P? processor on/off states 
Breakpoint addresses and number of 
resiaining (f^axlmuai 9999) for both CPU 
active I 

Trace Units for both CPU and PPs Uf active) 
CP SPY address limits Mf active) 



run counts for both CPU and 

or run.pp comfflands 

CP instruction tlases 11 f CP 



breakpoints 
and PPs (if 



dispt ay.Inf o 

Sanple output Csome lines truncated due to ERS line length): 

di spi ay.i nf 

QUALIFIERS? ADDRESS.IiODE* PVA EXCHANGE* JOB 9?* 03D 

FILE.NAME» UNQUAL OBUG.FILE* UNGUAL 

LAST.CP.RUN.COUNT* 142 TOTAL- 126142 

LAST.PP.RUN.COUNT» 100 TOTAL* 126000 

CP.TIMING LAST RUN 0.000 073 886 TOTAL 0.063 452 331 



CONFIGURATION 


« 


CPU 




PPOO 


PPOl 


PP02 PP03 


STATUS? 




ON 




OFF 


ON 


OFF ON 


8RKPT?REF XP 




JOB 










ADDRSS 


OOE 


0000 


8800 




7711 


4220 


REMAIN 




8 






2 


9999 


TRAC£?R£F XP 




0001 


2C80 








LIMITS 


OOE 


0000 


1000 




0700 






OOE 


0000 


FFFF 




5500 




SPY ? REF XP 




MQN 










LIMITS 


OOA 
OOA 


0000 
0000 


1600 
1700 
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3.0 DESCRIPTION 

3.7.11 DISPIAY^MEHORY T DM 

The purpose of the DISPLAY. MEMORY comm^mi Is to display the 
contents of a field of simulated central roeroory. The field of 
fflemory displayed is specified as a starting byte address plus 
optional offset and a byte count of 1 to 8 bytes. Successive 
fields may be displayed by specifying the number desired as a 
yalue for the repeat.count parameter. 

Memory "dumos** may be taken i^ith this command by specifying 
a filename to receive the output. 

displ ay^menory first. byte. address*<rma or pva> 

Cof fset»<count>3 
tbyte.count=<count>3 
C repeat. count" <count>3 
If I le.na«€«<local file name>1 
Cexchange«<e xchange.de si gnator>3 
C address. mode«<mod€.desi gnator>3 

first. byte.address « fbas This parameter specifies the 
starting byte address of the the memory field that 
is to be displayed. It Is interpreted as a PVA or 
RMA according to the address. mode parameter. Ring 
numbers are optional and ignored If entered as part 
of a PVA. 

offset 5 o? This parameter specifies a byte offset which 
Is to be added to the first. byte. address to form the 
starting byte address of the memory field to be 
d Ispl ayed. 

Default. If no value is specified for this 
parameterf than a value of zero CO) Is assumed. 

hyte.count J be? This parameter specifies the length of 

the field of central memory that is to be 

displayed. The valid range for this parameter Is 
1..8 bytes* 

Default. If no value is entered for this parameter* 
then 8 bytes il word) is assumed. 

repeat. count * rcs This parameter specifies the number of 
fields to be displayed. The valid range for this 
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3.0 DESCRIPTION 
3.7.11^0ISPIAY,J1EI10RY^|^DN^^ 

parameter is l«»n» 

Default. OfDission of this paraineter **i M cause a 
default of one <ll field to be assumed. 

flle.naiie * fnt This paraweter specifies the nawe of a 
local file which Is to receive the iwewory display 
output* A wide line printer format is used when a 
file naine Is quoted* and each cowfwand execution 
writes a separate record on the file* Values 
accepted for this parameter areJ 

1» fn« <local file nafBe> Any valid NOS file name is 
accepted* This file name temporarily overrides 
any qualified file. name established previously 
by a QUAIIEY.REFERENCE cofflsiand. 

2* fn« UHQUAL t UNQ This value Is used to negate 
any flle^nawe quai I i f i cat i on in effect due to a 
previous QUALIFY. REFERENCE coroifiand* The fflewory 
contents display Is then output to the 
terminal • 

Default* If this parameter Is not specified and 
there Is no flle.fiaRie qualification in effect* then 
the ffleaiory contents display is directed to the 
ternilnal* If there is a file. name qualification in 
effect* then the output will be to the qualified 
f i le* 

exchange « excJ This parameter specifies the •frame of 
reference* for the command* ie* It specifies to 
which exchange package this command applies or which 
exchange package is to be used for virtual address 
translation* Values accepted for this parameter 
ares 

1« exc* JOB This value sets the frame of reference 
for this command to be the current job exchange 
package as located by the contents of the Job 
Process State (JPS) register* 

2* exc« MONITOR S HON This value sets the frame of 
reference for this command to be the current 
monitor exchange package as located by the 
contents of the Monitor Process State CliPS) 
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register. 

3* exc« UNQUAL \ UNO This value Is used to override 
any exchange parameter qiual i f Icati on in effect 
due to a previous QUALIFY^REFEREMCE cotnwand. 
When UNQUAL is given* the frame of reference 
for this cofljwand is the exchange package of the 
current mode as deternsined by the mode bit in 
the Status Suwuary (SS) register. If the 
current CPU mode is monitor* then the frawe of 
reference Is the monitor exchange package 
pointed to by the HP$» If the current mode is 
Job 9 the exchange package pointed to by the 
4PS is the fraiae of reference. 

^. exc* <address> The real faemory address CRHA) of 

an exchange package may be specified to 

designate that exchange package as the frarae of 
reference for this command. 

Default. If the exchange parameter is not entered 
for the command* then the frame of reference for the 
command Is determined in one of two wayss 

CD If a previous qual If y_r ef erence command had 
qualified the exchange parameter for subsequent 
commands* then that value Is used as the frame 
of reference for this command* 

<2I If the exchange parameter was not 
previously qualified by QUALIFY.REFERENCE* then 
the frame of reference is determined from the 
current mode in the Status Summary <SS) 
register and its corresponding process state 
register - MPS or JPS. 

address. mode • am: This parameter dictates hovi the 
first. byte. address parameter Is to be interpreted - 
whether as a process virtual address CPVA) or as a 
real memory address (RMA). Accepted values for this 
parameter are: 

1. a«« PVA This value Indicates virtual addressing 

mode. 

2. am* RMA This value indicates real memory 

addr essi ng mode. 
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3.7.11 OISPIAY.MEMQRY f DH 



Default* If this parameter Is not specified then 
the mode used is the value established by a previous 
QUALIFY.REFERENCE command. If no address node had 
been established by a QUALIFY. REFERENCE command* 
then RHA Is assumed* 

Exampless 

disp I ay.fflemory f Ir st_byte_addr ess*4009< 16) am»rflia 

displ ay.iuemory fba«2000C16) byte.count-4 repeat_count=20 

dm f ba«800000309a< 16) bc*2 rc-8 exc«job ain^pva 

dm 1100009000(16) rc=500 exchange = inon i tor 

4m 0b00000000a00C16) o=16#»40 exc«3000(16) 

6m 1200000000C16) rc=0fffC16) excjob a»i*pva fn^duuipl 

Saipple output Csowe lines truncated due to ERS fine lenpthls 

displ ay.fwewor y f ba«100a00001692< 16) rc»12 a««pya exc = job 

SEGHENT* lOOA 

00001692 20212223 24252627 28292A2B 2C202E2F I "# $%S« <)*♦ 

000016A2 30313233 34353637 38393A3B 3C303E3F 0123 4567 89:? 

00001682 40414243 44454647 48494A48 4C404E4F 3A8C DEFG HIJK 

000016C2 50515253 54555657 58595A5B 5C5D5E5F PQRS TUVW XYZC 

000016D2 60616263 64656667 68696A6B 6C6D6E6F Vabc defg hijk 

000016E2 70717273 74757677 78797A7B 7C707E7F pqrs tuvw xyzC 
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3»7,12 DISPlAY^MEilQRY. INDIRECT J DHI 

The purpose of the DISPLAY^MEHQRY. INDIRECT coffluiand is to 
display the contents of a field of simulated central roepory by 
specifying the starting byte address indirectly* The starting 
byte address is obtained froa the named state register* 
A-registerf X-register or TQS register specified in the 
comwandf added to the offset paraaseter yaiye* if quoted* 

Hewory ••dumps'* may be taken Kith this command by specifying 
a filename to receive the output* 

dlsplay.neiaory^lndirect Csreg*<s tate^register_nam€>3 

Careg«<a.regi ster.number>] 
£xr€g«<x.regi ster_number>3 
Ctos«<tos.register_number>3 
Cof f set«<coynt>l 
tbyte.count*<count>1 
Cr€peat.count*<count>3 
Cf i le_naaie»<l ocal file name>3 
Cexchange=<exchange_des ignator>3 
£ address«Mocle«<mode_designator>3 

sreg * ss This parameter specifies which named state 
register contains the first byte address of the 
field of central memory to be displayed* Only one 
Cil register may be quoted* Valid names ares 

DI I DLP ! 0« J EID ! FRC 5 JPS 
J KM J tPI ; IRN J MCR I MDF J MOW 
01 ! PFS J PIO 1 PIT ; P 5 PND 
? PTM J SIT 1 SS \ STA J STL S TE 
UP ; UVMID J VMCL J VMIO 

areg J a: This parameter specifies which A-register 
contains the first byte address of the field of 
central memory to foe displayed* Only one (1) 
register may be quoted* 

xreg t xJ This parameter specifies which X-register 
contains the first byte address of the field of 
central memory to be displayed* Only one CI) 
register may be quoted* 

tos « ts This parameter specifies which TOS register 
contains the first byte address of the field of 
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central memory to be displayed* Only one III 
register may be quoted* 

offset J OS This parameter specifies a byte offset which 
is to be added to the contents of the register given 
by the SRE6* AREG> XREG or TOS parameter to form the 
starting byte address of the wemory field to be 
displayed* 

Default* If no value is specified for this 
parameter* than a value of zero (01 is assui^ed* 

byte. count * bet This parameter specifies the length In 
bytes of the field in central mewory to be 
displayed* The valid range of values Is l««8« 

Default* If no value Is given for this parajaeter* 
then a field length of eight (8} bytes will be 
displayed* 

repeat. count • rcJ This parameter specifies the nui^ber of 
successive luewory fields to be displayed starting at 
the address forised by the contents of the quoted 
register plus the offset value* The valid range for 
this parameter Is l.*n* 

Default* If no value is quoted for this parainetert 
then a repeat count of one CD is assumed* 

flle.naiRe » fns This parameter specifies the name of a 
local file which Is to receive the memory display 
output* A wide line printer format is used when a 
file name Is quoted* and each command execution 
writes a separate record on the file* Values 
accepted for this parameter are: 

1. fn« <local file name> Any valid NOS file name Is 

accepted* This file name temporarily overrides 
any qualified file. name established previously 
by a QUALIFY.REFERENCE command. 

2. fn* UNQUAL J UNO This value Is used to negate 

any file. name qua i I I f I cati on In effect due to a 
previous QUALIFY.REFERENCE command. The memory 
contents display is then output to the 
terminal • 
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3,7.1E^DISPtAy.H|JJQRYj.INDIR|CT l^^^l^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

Default* If this para^etef is not specified and 
there is no flle.name qualification in effect* then 
the memory contents display is directed to the 
terminal* If there is a file.naiiie ^luall f icat i on in 
effectf then the output viill be to the qualified 
file* 

exchange ' exes This paramieter specifies the 'fraffle of 
reference' for the commandf ie« It specifies to 
which exchange package this command applies or which 
exchange package is to be used for virtual address 
translation* Values accepted for this parameter 
are J 

!• exc* JOS This value sets the fraroe of reference 
for this cofsfnand to be the current job exchange 
package as located by the contents of the Job 
Process State CJPSI register. 

2. exc* HONITOR t HON This value sets the frajse of 
reference for this coBimand to be the current 
monitor exchange package as located by the 
contents of the Monitor Process State (HPS) 
register* 

3* exc* UHQUAl * UNQ This value is used to override 
any exchange parameter qualification In effect 
due to a previous QUAtlFY^REFERENCE cofliwand. 
When UNQUAt is given* the frawe of reference 
for this coaimand is the exchange package of the 
current wode as determined by the mode bit In 
the Status Sujiiniary CSS) register* If the 
current CPU mode Is monitor* then the frawe of 
reference is the monitor exchange package 
pointed to by the MPS* If the current mode Is 
Job ♦ the exchange package pointed to by the 
JPS Is the frame of reference. 

4. exc* <address> The real memory address <RMA) of 

an exchange package may be specified to 

designate that exchange package as the frame of 
reference for this command* 

Default* If the exchange parameter is not entered 
for the command* then the frame of reference for the 
command Is determined In one of two Mays: 

(1) If a previous qual If y.ref erence command had 
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3.0 DESCRIPTION 

3,7«12 DISPLAy.HEHORY.INOIRECT I DHI 



qualified the exchange parameter for subse<iuent 
commmndsf then that vatue is used as the frawe 
of reference for this command. 

<2> If the exchange paraiaeter was not 
previously qualified by QUAtlFY.REFERENCEf then 
the fraie of reference Is determined from the 
current laode in the Status Suwfaary (SS> 
register and Its corresponding process state 
register - n?S or JPS» 

tddress.Riode * aws This parameter dictates how the first 
byte address value In the register Is to be 
interpreted - whether as a process virtual address 
CPVA) or as a real memory address CRMA)* Accepted 
values for this parameter ares 



I. 



2« 



am* PVA 
niode • 



This value Indicates virtual addressing 



aw* RHA This 
addressing i 



value 
ode* 



Ind icates 



real 



memory 



Default* If this paraaieter is not specified then 
the mode used Is the value established by a previous 
QUALIFY.REFERENCE copiaand* If no address mode had 
been established by a OUALIFY^REFERENCE commandf 
then RHA Is assumed* 

Exampl es: 

disp I ay.weflior y_i nd I rect sreg*Jps r epeat_count«52 

displ ay^wemory^i nd ir ect a«4 bc«6 address. wode«pva 

dfBi x«0bU6) 0=40(16) bc»4 rc«20 

dffii t«14 

dmi s«p rc«1000{16) am«job fn^dumpni 

Sample output Csome lines truncated due to ERS line length): 



dial s*p bc*6 rc«8 exc*Job aw«pva 



SEGMENT* 
00001692 
0000169E 
000016AA 
00001686 



lOOA 

20212223 

2C202E2F 

38393A3B 

44A54647 



2425 
3031 
3C3D 
4849 



26272829 
32333435 

3E3F4041 
4A484C4D 



2A2B 
3637 
4243 
4E4F 



ft 


$% 


S*C) 


»-./ 


01 


2345 


89:; 


<« 


>?3A 


DEFG 


HI 


JKLM 
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3.7*13 OISPLAY^PP^MENORY I DPM 

3.7.13 OISPIAY.PP.MEHORY I DPH 

The purpose of the OISPtAY.PP^WEMQRY commzn6 is to display 
the contents of a word or a consecutive number memory words of 
a specified simulated ??• 

Mewory "dumps" may be taken with this command by specifying 
a filename to receive the output* 

displ ay.pp.weiBory Cpp.number«<pp.number>3 

f irst_i*ord.a<idress«<word_address> 

Crepeat.count*<count>3 

Cf I le_na«e«<local file name>3 

Cfor»at*<format des i9nator>J 

PP. number * ppt This parameter specifies the number of 
the PR to which this command applies* The P? may be 
in either an 'on* or »off* state* 

Default* The pp. number parameter is optional only 
if there is a currently active qualified ?P number 
which was set up by a previous QUALIFY.REFERENCE 

command* 

f irst.Mord.address J fwas This parameter specifies the 
starting word address of simulated PP memory that is 
to be displayed* 

repeat.count « res This parameter specifies the number of 
consecutive PP memory words that are to be 
displayed* 

Default* If no value Is given for this parameter 
than a value of one CI I Is assumed* 



file. name I fm This parameter specifies the name of a 
local file which is to receive the memory display 
output* A wide line printer format is used when a 
file name is quoted* and each command execution 
writes a separate record on the file* Values 
accepted for this parameter ares 

1* fn» <local file name> Any valid NOS file name is 
accepted* This file name temporarily overrides 
any qualified file. name established previously 
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3,0 DESCRIPTION 
3.7,13^DI$PtAY.£P^MEfi05Y^; OPM^^ 

by a QUALIFY.REFERENCE cowsiand, 

2. ffii« UNQUAt » UHQ This value is used to fiegate 
any flle_«a«e <9yai I I f fcation in effect due to a 
previous QUALIFY. REFERENCE comwand* The memory 
contents display is then output to the 
tennlnal • 

Default* If this parameter is not specified and 
there is no file.iiane qualification In effects then 
the raeiBory contents display is directed to the 
terminal* If there is a flle^name qualification in 
effects then the output will be to the qualified 
file. 



fornat * f* This parameter selects the forifiat of the pp 
wemory display* Values accepted for this parameter 
ares 

1* f* OCT ? Addresses and meiRory contents are 
duiBped in octal forroat* Interpretation of 
weiiiory contents is presented In Display Code* 

2* f« HEX J H Addresses and metaory contents are 
displayed in hex format with Interpretation of 
fnewory contents given in ASCII* 

Default* Octal format Is the default* 

Exampl ess 

dispi ay.pp.fnewory pp. nufliber = 5 f i rst.wor d.address*100C 8) 20 

displ ay.pp.wefliory pp-5 fwa-2000(8» repeat. count«40 

dpm 5 2000(8) 40 

dpifi 10C8) 

dp!af#70(8) 8 

dpJB 3 rc«4096 fn«duffippp3 f«h€x 

Sample outputs: 

di spl ay.pp.mejnor y pp*3 fMa=5670C8) rc*10 

PP03 

5670 151530 001531 001532 001533 MX MY HZ MO 

5674 001534 001535 001536 001537 Ml M2 M3 M4 

5700 001540 001541 M5 M6 

dpm 3 fv*a«200C16) rc»23 f«hex 
PP03 
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2G0 3D30 3131 3232 0033 0034 0035 3636 0037 00 11 22 3 4 5 
208 0038 3939 003A 0038 003C 0030 003E 003F 8 99 s | < « 
210 0040 0041 0042 0043 0044 0045 0046 3 A B C E F 
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3. 7.14 DISPLAY.PP.RESISTER I 0?^ 

The purpose of the DISPLAY.PP.REGISTER coi«^and is to 
display the contents of the simulated A» P and R registers of 
a specified ?P* 

displ ay. pp. register Cpp. fiu»ber = <pp. number >1 

Cregs»<regi ster.nai»e>1 

PP.nusber * ppt This parameter specifies the number of 
the PR to which this copmand applies* The 9? may be 
In either an * on* or *off« state* 

Default. The pp.nuMber parameter Is optional only 
If there Is a currently active qualified P? number 
Hhich was set up by a previous QUALIFY.REFEREHCE 

command* 

regs This parameter specifies the name or names of the 
PP register that is to be displayed* Valid values 
for this parameter are A* P or R* 

Default* If no register name Is entered for this 
command* then the A and P registers will be 
displ ayed* 

Examples: 

d Ispl ay.pp. register pp. number»4 regs«lafP#r> 

dl spl ay. pp. r eg I ster pp«4 (a*rl 

dpr 4 p 

dpr 9 

dpr fff 

dpr 

Sample output: 

display.pp.r eglster pp«9 regs«{p»afr) 
090 P« 4211 A« 053126 R« 00100400 
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3,0 DESCRIPTION 

3,7.15 DISPLAY.REGISTER 5 DR 



3*7.15 OISPiAY.REGISTER I DR 



The purpose of the DISPLAY.REGISTER cowaiand Is to display 
the contents of specified CPU registerCsl* Registers nfiicti 
way be displayed include the Processor State Registers and the 
Process State Registers lExchange Package registers). 



displ ay^reglster Csf egs»<state^regi ster^nafpe>3 

Caregs«<a.regi ster^nuisher >1 
Cxregsa<x_regi ster_nui«ber>1 
Etos«<t OP. of.stack.regist€r.nufnber>1 
Cexcliange»<exchange.des i gnator>l 

sregs I ss This parai^eter specifies a na^ed state 
register Iprocessor and/or process state register) 
which is to be displayed* Multiple State registers 
miy be specified up to a maxlsiuin of five (51* Valid 
na«es which way be given ares 



8C t 


1 CFF 


KCN * 


1 KC I 


nn \ 


! HPS 


PSH ' 


1 PTA 


TP ; 


UCR J 



J DEC t DI I OLP i OH I EID J FRC I JPS 
KEF i KM J tPI I LRN J NCR \ HOF S MOW 
I QCF I 01 ? PFS i PIO 5 PIT S P ? PND 
PTl S PTM J SIT S SS I STA J STL t TE 
UM 5 UP 5 UVMIO S VMCL i VMID 

aregs « a: This parameter specifies which A-reglster or 
registers are to be displayed* Multiple A-registers 
and/or ranges way be requested to be displayed* The 
limit Is five <5) A-reglsters or ranges per 
cofflfliand* 

xregs 5 xs This parameter specifies which X-reglster or 
registers are to be displayed* Multiple X-registers 
and/or ranges may be requested to be displayed* The 
limit is five C5) X-reglsters or ranges per 

command* 



tos J ts This parameter specifies which TOS register or 

registers are to be displayed* Multiple TOS 

registers and/or ranges may be requested to be 

displayed. The limit Is five <5I TOS registers or 

ranges per command* 

exchange 5 excJ This parameter specifies the «frame of 

reference^ for the command* ie* it specifies to 
which exchange package this command applies or which 
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3.7.15 OISPLAY^REGISTER t OR 

exchange package is to be used for virtyal address 
translation. Values accepted for this parameter 
ares 

1. exc« JOB This value sets the fraae of reference 

for this command to be the current job exchange 
package as located by the contents of the Job 
Process State <JPS> register. 

2. exc* HOHITOR I HON This value sets the frame of 

reference for this command to be the current 
monitor exchange package as located by the 
contents of the Monitor Process State IHPS) 
regi ster • 

3. exc* UNQUAt T UNQ This value Is used to override 

any exchange parameter gual if Icatlon In effect 
due to a previous aUALIFy^REFERENCE command. 
When UNGUAL Is given? the frame of reference 
for this command is the exchange package of the 
current mode as determined by the mode bit in 
the Status Summary (SS) register. If the 
current CPU mode is monitor^ then the frame of 
reference Is the monitor exchange package 
pointed to by the MPS. If the current mode is 
Job f the exchange package pointed to by the 
JPS Is the frame of reference. 

4. exc« <address> The real memory address IRMAI of 

an exchange package may be specified to 
designate that exchange package as the frame of 
reference for this command. 

Default. If the exchange parameter is not entered 
for the command* then the frame of reference for the 
command Is determined In one of two ways: 

(1) If a previous quallfy^reference command had 
qualified the exchange parameter for subsequent 
commands* then that value is used as the frame 
of reference for this command. 

(2) If the exchange parameter was not 
previously qualified by QUALIFY. REFERENCE* then 
the frame of reference Is determined from the 
current mode in the Status Summary CSS) 
register and its corresponding process state 
register - MPS or JPS. 
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Examples: 

display. register sregs«p 

displ ay.reglster s-C Jps#ffips>ucrf iicr»p} exchange«Job 

dr aregs«9 xregs«( 2^ 5» 7f bf f ) tos«Cl»»f) 

dr s«ss a«C0f 4««8f d»«f I 0»*f exc«nio«itor 

Sample outputs 

di spl ay.regi ster s^lpfss) a»(0««2) exc«job 

P«0000 300E 0000 823C S$»0000 0000 0000 0000 

AO « 3017 0000 0220 Al « 3017 0000 0220 

A2 » 3017 0000 01C8 
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3.7«16 DISPIAY^STACK^FRAHE t DSF 

The DISI^LAY.STACK.PRANE command provides the <llsplay of 
selected Infortiatlon frbw a specified stack frafse or a number 
of consecutive stack frawes» 

displ ay^s tack, fr awe Cstack.fr aiie«<fraBie nuiRber>1 

Crepeat.coufit»<coynt>1 
Caddress*<pva>1 

Cse I ector*<s€ lector designator>l 
Cauto.i efigtli«<count>3 
£ ex changes <e xchange.de si gnator>3 
Idbug.f I le«<l ocal.fi I e.nasie>3 

stack. frame * sfs This parai»eter specifies the number of 
the first stack frame for which Information Is to be 
displayed* Stack franie number one Is associated 
with the interrupted procedure (the exchange 
package) or i^ith the stack frawe associated nith the 
address parafweter# If specified* Stack frame two Is 
associated with the first stack frame procedure's 
predecessor* etc* The valid range for this 
parameter is 1 •« 999* 

Default* If the stack frame parameter is not 
specified* then the first stack frame for which 
Information Is displayed will be the exchange 
package or the stack frame associated with the 
address parameter (If specified)* 

repeat.count * re: This parameter specifies the total 
number of stack frames for which Information Is to 
be displayed* The valid range for this parameter Is 
I «* 999* If this value exceedes the number of 
stack frames* output will terminate with the last 
frame in the stack* 

Default* Information for one stack frame is 
d ispi ayed* 

address * as This parameter specifies the process virtual 
address (PVA) of a stack frame save area at which 
the trace back begins (stack frame number one)* 
Ring numbers are optional and ignored If entered as 
part of a PVA* 
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Defauit* If the address parafReter Is not specified* 
stack fraiae ny«feer one is the interrupted procedyre 
i the exchange package). 

seiect{>r I SJ This paraaeter Identifies a region of the 
specified stack fraweCs) which Is to be displayed* 
Accepted values for this parameter ares 

1« s« AUTO This value causes the automatic region 
of the stack frawe to be displayed* 

Zm s* SAVE This value causes the save area of the 
stack fraiae to be displayed* 

3« s« FULL This value causes both the automatic and 
save areas of the stack fra?se to be displayed* 

Default* The full mode is used ^Hen this paraiseter 
is not specified* 

auto. length * als This parameter specifies the number of 
characters of the automatic region of the stack 
frame<sl to be displayed* Full *«ords are 
displayed* The valid range for this parameter Is 1 
•* 1000000* 

Default* If this parameter is not specified and the 
selector parameter Is auto» full* or default* a 
maximum of 960 bytes of the automatic region are 
d Ispi ayed* 

exchange I exc: This parameter specifies the *frame of 
reference' for the command* ie* it specifies to 
uhlch exchange package this command applies or nhich 
exchange package Is to be used for virtual address 
translation* Values accepted for this parameter 
are! 

1* exc« JOB This value sets the frame of reference 
for this command to be the current job exchange 
package as located by the contents of the Job 
Process State CJPS) register* 

2* exc* MONITOR ! HON This value sets the frame of 
reference for this command to be the current 
monitor exchange package as located by the 
contents of the Monitor Process State (MPS) 
r egl ster * 
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3. exc* UHQUAL 5 UNQ This value Is used to override 
any exchange parameter qualification In effect 
due to a previous QUAIIFY.REFERENCE coi»8iand. 
yheri UNQUAL Is given* the frafRC of reference 
for this coffifnand is the exchange package of the 
current mode as deteri»lned by the aode bit in 
the Status SuwBiary CSS) register* If the 
current CPU mode is iBonttor* then the frame of 
reference is the monitor exchange package 
pointed to by the HPS« If the current mode is 
job » the exchange package pointed to by the 
JPS is the frame of reference. 

4« exc* <address> The real memory address CRfIA) of 
an exchange package may be specified to 
designate that exchange package as the frame of 
reference for this command. 

Default. If the exchange parameter is not entered 
for the commandf then the frame of reference for the 
command is determined In one of t»40 ways: 

<l) If a previous quallf y.ref erence command had 
qualified the exchange parameter for subsequent 
commands* then that value Is used as the frame 
of reference for this command* 

(21 If the exchange parameter nas not 
previously qualified by QUALIFY^REFERENCE* then 
the frame of reference Is determined from the 
current mode In the Status Summary CSS) 
register and its corresponding process state 
register - HPS or JPS. 

dbug.file I dfs This parameter specifies the name of the 
local file Mhich contains the debug module address 
table produced by VEIINK. Values accepted for this 
parameter ares 

1« df« < local file name> Any valid NOS file name Is 
accepted* This file name temporarily overrides 
any qualified dbug.frie established previously 
by a qua! Ify.ref erence command* 

2. df» UNQUAL I UNQ This value is used to negate 
any dbug.flle qualification In effect due to a 
previous QUALIFY^REFERENCE command* No module 
names and offsets appear in the stack frame 
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dispt ays » 

Default* If the dbug.fi ie parafueter Is not entered 
for the coififfland* the dbug.flle na«e is determined in 
one of two ways? 

<1) If a previous qyal If y.ref erence command 
had qualified the dbug.file for subsequent 
coinmandsy then that value is used as the 
dbug.flle nawe for this command* 

(2) If the dbug.fiie nawe was not previously 
qualified by QUALIFY.REFERENCE* the dbug.file 
remains unqualified* 

Examples^ 

di spl ay«.stack.fr awe rc«3 selector=save 

dlspl ay.stack.fraiwe a«300000098C16) sf«2 s«full 

dsf sf»4 repeat. count«6 exc«Job al«1640 

dsf selector*auto auto.l ength»10000 
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3.7.17 HELP I H 



The purpose of the HELP command is to provide a handy# 
concise presentation of the syntax of the Simulatof coaiwands* 
The Intent of this cowhand is to offer the interactive 
Simulator user a condensed syntax to serve as a wewory 
refresher* and Is not intended to be a tutorial on the consmand 
set of the Slwulator nor is any atteiapt wade to present the 
cominand syntax in the standard SCL notation. 

The HELP cofisisand provides a nseans to (1) display all of the 
Simulator comj^ands and their aliases* C2) list the abbreviated 
syntax of a par ticul ar command. 



help Ccoauiiand*<co!mi}and.naflse>l 

connand « cmd: This parat^eter is used to specify a 

command whose syntax Is to be displayed. The full 

command name or Its alias may be given for this 
par aflieter • 

Default* If this parameter is not specified on the 
HELP cofflinand* then a complete listing of the 
Simulator command names and their aliases will be 
di splayed. 

Examples 2 
help 

help co!Biiand«d I sp I ay.regl sters 
help cfl»d«displ ay_r eglsters 
h pp^trace 
h t 

Sample output: 

help load. memory 

LOAO.MEMQRY FILE.NAHE* PI FIRST. BYTE. ADDRESS^ P2 

LH FN« PI F8A» P2 
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3,7.18 INCLUDE I INCl 

The purpose of the INCLUDE command Is to designate a 
copwand file to serve ^s the current input source. The 
comfliand file consists of one or ?Bore valid Simulator 
conmandCs)* Command text is taken frota the new source 
lumediateiy* If more cowmand text foilovfs the INCLUDE 
command* it Is processed after the new coi^mand file contents 
are processed* 

NOTES INCLUDE Ing a comaiand file does NOT cause it to be 
executed* Execution occurs upon entering a subsequent 
carriage return* either by itself or following the next 
cowwand entered* Cowmands are always executed In the correct 
order* 



Include cf *<f I le^na»pe> 

cfs This parameter specifies the name of the local file 
which contains the Simulator comfflands to be include 
d* Any valid NOS file na«e is accepted for this 
parameter* 

Exaflipl es5 

include fllex 
inci ude cf»f i I ey 
incl cmdfiie 
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3.7.19 LOAD.HENQRf J IM 

The purpose of the LOAD^MEHORY co!n«and is to loa^ the 
contents of the specified Tocal file Into simulated central 
memorym The load file wust be the foriat of the segment file 
vfhich Is output hy the SES Virtual Environment Linker* 

This co!9fl)and may be used repeatedly to load multiple 
segments from different load files if necessary* 

CAUTIONS Due to the differences in the CYBER 170 and CY8ER 180 
word lengths* there may be up to three C3I bytes of extraneous 
data loaded into simulated memory at the end of a load file* 

toad.nenory f I le^name«<l ocal^f i I e_name> 
£ f I rst.byte.addr ess«<rma>l 

file. name J fn? This parameter specifies the name of the 
local file «hich contains the CY8ER 180 memory 
segment or segments. The format of this file is 
described in the ERS for SES Virtual Environment 
linker* This file is rewound before loading* 

first. byte.address J fbaJ This parameter specifies the 
starting byte address (RHA) for the load* 

Default* If this parameter is not specified then 
the first byte address of the load Is obtained from 
from the load file* If the file does not contain 
the first byte address* then the load will start at 
real memory address zero <0)* 

Examples? 

load^memory f i I e«name«segml01 f i rst.byte_address»2000(16) 
load. memory fn«sega fba*<^OFE< 16) 
Im segf i I 
Im segf i I 
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3.7*20 tOAO.PP.HEHORY i IPM 

The purpose of the LOAO.PP.HEHORY coi»«and Is to load the 
contents of the specified local file Into the simulated memory 
for the specified P?* The file way be either a binary file 
oytput froM CYBER 170 Compass PP assembly or a binary file 
from a CY8ER 180 Coinpass assembly. The file is rewound before 
loading* 

load.pp^newory f 1 1 e.naflie*<l ocal.fi f e.nai»e> 

Cpp_n««ber*<pp.nurober>3 
Cf Irst^nord. address *<word_address>3 

file. name « fnJ This parameter specifies the name of the 
local file »*h i ch contains the binary memory file 
output from either a CYBER 170 or a CYBER ISO 
Compass ?P assembly. 

PP.nanber « pps This parameter specifies the number of 
the ?P to which this command applies. The P? may be 
In either an * on* or 'off* state. 

Default. The pp. number parameter is optional only 

if there Is a currently active qualified PP number 

which was set up by a previous QUALIFY.REFEREHCE 
command. 

f irst.word.address * fwa? This parameter specifies the 
starting word address for the PP memory load. 

Default. If no value is quoted for this parameter* 
than the starting word address of the load will be 
obtained from the tables in the load file. If there 
Is no starting address In the load file table* then 
ultimately the load will begin at PP word address 
zero 101. 

Exampl es: 

load.pp.memory f 1 1 e.name«ppload pp.number*0 fwa«0 

I oad. pp. memory fn*pploadx pp»^ fwa«2000(8) 

Ipm f I lea 4 200(81 

Ipm mtrbin 

Ipm mtrbln*»3000<8) 
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3.7.21 OFF 



The OFF command is used to turn off a specified P? and/or 
the CPU* A ?P or CPU in an *off» state Is reffloved from 
Instruction slfaulation* The special ^escape" instructions 
used to transfer control between CPU and PP Instruction 
simulation are treated as NO-OP Instructions if the processor 
or processors being transferred to Qtt* i»e» CPU or all PPs 
are off. 

It is also used to deactivate CPU instruction tlialng and 
»SPY" CPU performance monitoring previously activated by an ON 
command* 



off Cpp.n««ber»<pp.nuiiiber>1 
Cepul 

Ccp.tiiiiingi 
CspyJ 

pp«ftu«lier « pp3 This parameter specifies the ?? which Is 
to be put in an *off' state* 

Default* If this parameter is not specified* then 

no PP Mill be turned off* This coRiwand does naJt 

default to a PP nuwber qualified by the 
QUAIIFY.REFERENCE command* 



CPU 



J cp5 If this keyword is entered* then the CPU will 
be put in an *off' state and removed from 
Instruction simulation* 



cp. tiding I ct? This keyword specifies that CPU 
Instruction tlwing Is to be turned off* Thereafter* 
an average CPU instruction time of I 
microsecond/Instruction Is used for updating 
hardware clocks* 

spy This keyword deactivates the SPY P-register 
monitoring established by the ON coimnand and causes 
the results to be written to the TRACE file 
SESSHTF* See Appendix B for an example of the SPY 
output* 

Examples: 

off pp.nufflber«9 

off CPU 
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off 
off 4 cp 
off ct spy 
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3.7.22 ON 



One function of the OH coaimantl Is to turn on a specified 9? 
and/or the CPU. A ?9 or CPU in an 'off* state Is removed frop 
Instruction sisiulatlon. This cowtnand puts the specified PP or 
CPU back Into an «on« state Nhere It nil I Included In 
Instruction sliRulatlon. 

This coTOfaand Is also used to activate CPU Instruction 
timing and to activate the **SPy" CPU performance monitoring 
feature. The current status of both CPU titulng and SPY limits 
and <iual If Icatlon can be displayed via the OISPtAY.IHFO 
coiiR^and. 



on Cpp.nuiiber=<pp^nufi!ber>3 
Ccpu3 

Ccp^t I w I ngl 
CspyJ 

Ci Iml ts«<star t^pva.. end_pva>3 
Cexciiange«<exchtnge.desi gnator>1 

PP.nuMber * pp* This parameter specifies the PP which Is 
to be put In an «on* state. 

Default. If this parameter Is not specified* then 

no PP will be turned on. This cowfuand does qhX 

default to a PP number qualified by the 

QUAtlFY.REFERENCE coroisand. 

CPU I cps If this keyword Is specif led* the CPU will be 
put in an «on* state. 

cp.tioiing " ctJ This keyword specifies that CPU 

Instruction timing Is to be turned on. Once on» the 

actual P2 instruction times for the CPU Instructions 

are used for updating hardware clocks. The 

accumulated CPU Instruction times are available via 
the display. info command. 

spy? This keyword activates CPU P-reglster monitoring for 
the range of addresses given by the limits parameter 
below. The P-register monitoring continues until a 
subsequent deactivation via the off command which 
causes the results Ccountst percentage histogram) to 
be written to the trace file SESSMTF (See Appendix B 
for ^n example of the spy output). A second on spy 
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replaces ttie first withoyt producing any oytput* 

iiwlts I M This parameter is used In conjunction with 
the SPY keyiford to specify the range of PVA«s In 
which the CPU P-reglster is to be monitored* The 
PVA's must be In the saroe segment* Ring numbers 
need not be entered as part of the PVA»s« They are 
Ignored If entered and ignored when testing against 
the P-reglster. 

The limits parameter is required if the spy keyword 
is quoted* 

exchange * excJ This parameter specifies an exchange 
package which Is to be used to "qualify** the spy 
llflilts* Values accepted for this parameter areJ 

1* exc= JOB This value Indicates that the spy 
limits apply only to any JOB exchange package* 

2* exc- HONITQR J HON This value indicates that the 
spy liwits apply only to any HONITOR exchange 
package* 

3* exc« UNQUAL I UNQ This value is only used to 
override any exchange paraiReter qualification 
in effect due to a previous QUALIFY.REFERENCE 
cOfBffland* When UHQUAl Is specified^ any 
previous exchange package parameter 
qualification Is overridden* and the spy limits 
will apply to any exchange package - JOB or 
MONITOR* 

4* exc* <address> The real memory address (RiiAl of 

an exchange package may be specified to 

designate a particular exchange package to be 
used to qualify the spy limits* 

Default* If the exchange parameter Is not entered 
for the command but there Is a current exchange 
parameter qualification due to a previous 
quallfy.reference command* then that value Is used 
and Interpreted exactly as described above* 
Otherwise* there Is no qualification and the spy 
limits will apply to any exchange package - JOB or 



MONITOR* 



Ex amp 1 ess 
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on pp.nu^ber«9 

on pp«0 CPU 

on 5 

on ct 

on spy I*0400001000(l6)«.0400001fff (16) exc«job 
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3.7«23 f>P. BREAKPOINT 1 P8 

The purpose of the PP.BREAKPOINT cowroand Is to specify a 
breakpoint address In a simulated ??• Execution of the 
Instruction at the PP breakpoint address In the specified P? 
causes the slfflulatlon to halt and a diagnostic message is 
displayed giving the PP number and breakpoint address* 

PP.br eakpo In t Cpp.n«aiber«<pp.nurober>1 
addr ess«< pp. addr ess > 
i:fre<iueficy«C<l>C«.<J>3C»<k>1)3 

PP.nuwber * pps This parameter specifies the nuisber of 
the PP to which this cosunand applies* The PP may be 
in either an •on* or •off state* 

Default* The pp.number parameter is optional only 

if there is a currently active qualified PP number 

which was set up by a previous QUALIFY.REFERENCE 
command* 

address J as This parameter specifies which PP address to 
breakpoint* 

frequency J fJ This parameter specifies the frequency 
conditions which must be satisfied in order for the 
breakpoint to be honored* The frequency may be 
specified In one of three forms? 

I. f« i This form will set a PP breakpoint which 
will be honored when the specified address is 
encountered on the Ith time and never 
thereafter* 

2* f« l.*J This form will breakpoint on the ith 
time the address Is encountered and every time 
thereafter until the jth time* 

3* f« (l**J»k) This form will breakpoint on the ith 
time the address Is encountered and every kth 
time thereafter until the jth time Is reached 
or exceeded* 

Default* If the frequency parameter is not 
specified on the commandf then the PP breakpoint 
will be honored each time it is encountered* 
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ExaiBpless 

PP. breakpoint pp.r!u»ber«6 address»3004( 81 
PP«bf eakpoint pp«0 3-500(81 fre<iuency*2 
pb 7 500(81 f«5..10 
Pb ,f2105(8l 



COMPANY PRIVATE 



COC ADVANCED SYSTEHS DEVELOPHENT 

15 Dec 81 
ERS for CYBER 180 Simulator 

simmm.*nitm»mmmmmimmmi>nmMH»m4mmni» rnt m m *» »t »t *» »t tm m »» mm urn* mi mgrnr mi m mmmmmmmmmmmmmmmrmmmmmmmmmmm 

3.0 OESCRIPTIQN 

lllliimttmVLm^mtmimVmmmmmmmmmmmmmmmmmmmmmmmm 

3«7,24 PP^TRACE I PT 

The purpose of the PP^TRACE cowmaod is to establish a range 
of addresses to be traced In a particular sJwulated P?* 
Instructions executed within the range limits of the specified 
99 are interpreted with the results written to the Simulator 
trace file ♦SESSHTF*. The 99 trace reisains active until 
nullified by a REMOVE^PP.TRACE cominand or a subse<iu€nt 
PP^TRACE coiBwand* Since only one 99 trace way be active at 
any one timef successive PP^TRACE conifliands o>teTt\4Q any 
previous on%» This Is true whether or not the specified 
PP^nuaber Is the same* 

99 trace Information usay be interspersed with CPU trace 
information If the CPU trace is also active. 



PP«tr ace Cpp.nyiiiber*<pp^nufiiber >1 

I lull ts« <s tart. a ddr es s*. end. a ddress> 

PP. nuaiber » ppi This parameter specifies the number of 
the 99 to which this cofnsiand applies* The 99 may be 
in either an 'on' or 'off* state. 

Default* The pp. number parameter Is optional only 
if there Is a currently active qualified 99 number 
which was set up by a previous QUAIIFY.REFERENCE 
c Ofsmand* 

iinits 3 1 2 This parameter specifies the limits or range 
of PP addresses which are to be traced* 

Examples! 

PP. trace pp.number»3# I imi ts»4100( 8) • .4210(8) 
PP. trace pp«3 I «200(8) .. 1300< 8 ) 
pt 9 7400(8). .7450(8) 
pt,, 7400(8). .7450(8) 

Sample output from trace file SESSHTF (some lines may 
be truncated due to ERS line length) 

07 ( A)«000000/000007 

00 

20 

13 (A)»000007 

2020,73 (73)«0017 ( 2037) «111023 ( A)»000007/00 

76 (A)»000003/000001 
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3*7.25 aUAlIEY^REFERENCE I QR 

The purpose of the QUALIFY.REFERENCE coaaand is to qualify 
the interpretation of certain parameters on subse<iuent 
Simulator cowwands. The effect of this cosjutand is to 
establish default values for the parameters of the cowmands* 
thereby ellflilnatlng the necessity of entering the parameters 
with every Sliiulator cosinnand. Only certain parameters can be 
qualified with this cowmand. These aret 

address. node I an 
exctiafige * exc 
PP.nuRibef * pp 
file.nane \ fn 
dbug.f ile I df 

All Slnuiator commands for Mhlch the address. node* exchanne 
and pp.nunber parameters are defined will use the default 
values set up by this comwand* The only exceptions to this 
rule are for the pp.number parameter for the on and off 
commands* 

The flle.naRie parameter applies only to the memory display 
commands* 

The dbug.fi le parameter applies only to the 
disol ay. stack. frame and trace. back commands. 

If a value is specified for these parameters on any 
subsequent Simulator commandt then its value Mill alM^lS 
override the qualified value established by this command. It 
♦<lll Q2t effect the qualification for other commands* 
however. 

Parameters qualified by this command remain in effect until 
a subsequent QUALIFY.REFERENCE to "unqualify* or to set up a 
new value. 



a 



qua I If y. reference C address. mode* <mode.desi gnator>l 

Cexchanges<exchange.des i 9nator>3 
Cpp«nuiiber*<pp.numb€r>3 
Cf I le.fiame*<local file naffle>l 
Cdbug.fi le«<local file name>3 

address. mode i am: This parameter establishes the default 
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yalye to be used for the address.wode paraiRetef on 
certain Siffiulator cowi^ands for which the parameter 
applies* but for which no value is entered* The 
address.fliode parameter dictates how the cowwand's 
f i rst_byte.address Is to be Interpreted - whether as 
a process vi rtual address CPVA) or as a real wemory 
address CRMA). Quoting a value for the address. iiode 
parameter on a co!«%and will always override the 
value established here by this coiaiaand# Accepted 
values for this parameter areJ 

1« a«» ?VA This value sets the address mode 
qualification to process virtual addressing* 

2» a»« RHA This value sets the address mode 
qualification to real memory addressing* 

Commands for which the address.node qualification 
appi les ares 

change.iiiewior y 

dlsplay.nenory 

dispi ay.mesiory.lndirect 

exchange I exc: This parameter establishes a default 
•frame of reference* for any subsequent Simulator 
commands for which the exchange parameter applies 
but for which no value Is entered* The frame of 
reference designates a particular exchange package 
to which a command applies or which exchange package 
is to be used in virtual address translation* 

Quoting a value for the exchange parameter on a 
command will always override the value established 
here by this command* Accepted values for this 
parameter ares 

1* exc» JOB This specifies that the default frame 
of reference is to be the current Job exchange 
package as located by the contents of the Job 
Process State IJPSI register* 

2* exc« HONITQR J HON This value specifies that the 
default frame of reference is to be the current 
monitor exchange package as located by the 
contents of the Monitor Process State CHPS) 
r eg! ster * 
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3.7,25 QUALIFY.REFERENCE I QR 



3. exc» UHQUAL 5 UNQ This value specifies that no 
particular frame of reference is to be the 
default arid reusoves any previous exchange 
qualification* Therefore* If a subsequent 
Slaiulator command does not specify an exchange 
parameter then it's frame of reference wl M be 
the exchange package of the current mode. This 
exchange package is determined by the mode bit 
In the Status Summary CSS) register - monitor 
or job siode - and located by the contents of 
the corresponding HPS or JPS register. 

4» exc* <rfaa> This value specifies an address CRMA) 
of an exchange package that is to be used as 
the default frame of reference* 

Commands for vihich the exchange parameter 
qualification applies are: 

breakpoint 

change.nemory 

change.r egister 

displ ay.exchange. package 

display.menory 

d I spiay.meaiory. Indirect 

display. regl ster 

on 

trace 

translate.pva 

PP.fiuaber I pps This parameter qualifies a PP number 
which is to be the defaulted value on any subsequent 
Simulator command for which the pp. number parameter 
applies but for which no value Is entered* The only 
exceptions to this ^re the on and off commands* 
Accepted values for this parameter ares 

1. pp« <pp.number> This specifies the PP number 
which will be the default* 

2* PP* UNQUAL I UNQ This value will nullify any 
current pp. nu«ber default value* 

Quoting a value for the pp. number parameter on any 
command will always override the default value 
established here by this command* Commands for 
which the pp. number qua 1 1 fi cati on applies are: 
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change.pp.iseiiory 
change.pp^reglster 
d i sp I ay.PP.nciior y 
displ ay^pp.reglster 
load.pp.flieiiory 
PP.br^akpoifit 
PP.tr ace 

renove.pp. breakpoint 
remove.pp. trace 

This qualification also applies to the display 

paraiaeter of the run.pp cosifBand* 

flie.naiie 1 fn* Specifies the naiae of a local file which 
is to receive the output frow the display memory 
coiBfnands. A wide printer line format is used *fhen 
this output is directed to a file. Accepted values 
for this para?Reter ares 

1* fn« <local file naffle> Nanie of file to receive 

the output. 

2. ffi* UNQUAl 3 UHQ This value mI I I nullify any 
flle.naiae qualification currently in effect* 

Quoting a value for the flle^naiiie parameter on any 
cowrnand will always override the default value 
established here by this conimand. Commands for 
which the file. name qualification applies ares 

displ ay. flieiiiory 

d i sp I ay.iieMory. indirect 

displ ay.pp.neiiiory 

dbug.fife J dfs This parameter specifies the najne of the 
local file which contains the debug module address 
table produced by VEtlNK. Accepted values for this 
paraffieter are? 

1. df« <local file na?iie> Name of the file 

containing the debug module address table* 

2. df« UNQUAL J UNQ This value will nullify any 

dbug.file qualification currently in effect. 

Quoting a value for the dbug.file par ameter wl I I 
always override the default value established here 
by this command. Commands for which the dbug.fi le 
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qualification applies ares 

displ ay_stack.fr ame 
tr ace.back 

ExaiApl es: 

<iual i f y.ref erence address.ssode^pwa exchange* Job 

qual i fy. reference pp. nu!«ber«5 

qr exc«unqual 

qr pp«9 fn»ppdu?Bp 

qr ri»a pp«unq 
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3*7,26 REHOVE. BREAKPOINT t RB 

The purpose of the REHOVE.BREAKPOINT command Is to remove 
any CPU breakpoint address established by a previous 
BREAKPOINT cotaiaand. 



f enove.bf eakpolfit 
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3«7«27 REMOVE^PP^SREAKPOINT J RPB 

The purpose of the REMOVE^PP^BREAKPOINT cowhand is to 
nullify a PP breakpoint address for the specified PP* 

r ewove.pp.breaicpolfit Cpp_fiuiiiber*<pp.number>1 

PP.nunber * ppi This paraiaeter specifies the nuisber of 
the 9? to which this command applies* The PP nay be 
in either an «on« or •off* state* 

Default. The pp. nuiiber parameter Is optional only 
if there is a currently active tiyailfied PP nuiwber 
i«hlch was set up by a previous QUALIFY. REFERENCE 
C03!i stand* 
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3»7»28 REMOVE.PP.TRACE I RPT 

The purpose of the REMOVE. PP.TRACE comm^na Is to nullify a 
currently active ?P trace which was previously established by 
the PP.TRACE command* Since only one PP trace fl^ay be active 
at any one time* it is not necessary to specify the ?P 
number* 



remove. pp. trace 
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3. 7.29 REMOVE^TRACE t RT 

3.7.29 REMOVE.TRACE \ RT 

The purpose of the REMQVE.TRACE cosifiiaiid Is to deactivate 
any current CPU trace which was previously set up by the TRACE 
cofiRiiand. 



re«iiye.tr ace 
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3.7«30 RESTART i RS 



The purpose of the RESTART co8?fflan<l is to establish the 
sisiulated envifonment that >«as captured on the checkpoint file 
specified* This checkpoint file laay be one that was 
previously created by the SEtJerate Qheck£oint £ile CGEHCPF) 
procedure* the Virtual £nvl roninent (iEHerator (V£S€NI» the 
Simulator checkpoint cowwand or the Extended ^eadstart Hump 
utility (EDO)* This coaisiand performs the same function as the 
RS parameter on the SIH180 procedure* 



restart Cf I le.naiie«<local_f I le„naffle>l 

flle^naaie * fni This parameter specifies the nane of the 
local checkpoint file. 

Default* If this parameters is not specified* then 
a cofflpletely new* ewpty simulated system envr ionment 
is created* 

ExaRjp t ess 

restart f i I e.najiie«cpf i I e 
rs fn«cpflie 
rs filex 
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3.7.31 RUN t R 



The purpose of the RUN coBimafid is to initiate or resume CPU 
instruction siffiuiation. The CPU simulation resumes execution 
accordlna to the current contents of the SS» HPS* JPS 
registers and the contents of the associated exchange package 
registers. The results of an instruction's execution may 
optionally be displayed at the terminal. 



Instruction simul at! on wi I I halt after the specified 

of CPU instructions. 



count 



run Ccount»<cpu_lnstruction_count>l 
Cdlspt ay3 

count J cs This parameter specifies the number of CPU 
instructions that are to be executed before halting 
simulation. 

Default. If this parameters is not specif led* the 
CPU instruction count Is set to an infinite value. 

display * ds This keyword causes the Interpretive 
execution of the CPU instructions to be displayed at 
the interactive user's terminal. This parameter Is 
only valid if the count parameter is also 
specif i ed. 

ExampI es3 

run count^lOOOOO 
run c«20 display 
r 10 d 
r 

Sample output from RUN with display In Job modes 



run 3 di spl ay 
J OOOOl^BE 96650155 8RXGT 
J 00001492 8B440001 ADDXQ 
4 00001496 2A47 ADDAX 
J 00001498 8517001A SA 

J 0000149C 84470000 LA 



X4=0000000000000002 
A7«30170000008A 

PVA«3017 000002CA 30170000008A 
A7«301700000088 
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3,7.32 RUN.PP t RP 

The purpose of the RUN.PP comwand is to Initiate or resume 
PP Instruction simulation. The P? simulation resumes 
execution according to the current contents of the 
p-reglsters* All PPs 1 n an lia state will be simulated In a 
manner comparable to the hardware "barrel and slot** 
aiechanisffl. The results of the specified PP>s instruction 
execution «ay optionally be displayed at the terminal* 

Instruction simulation will halt after the specified count 
of ?? instructions. 

ron^PP C coun t «<pp_ i ns t r uct I on. count >1 
Cdlspl ay«<pp.nu8!ber>l 

count « cs This parafneter specifies the nui^ber of PP 
instructions that are to be executed before halting 
siifiul atlon. Each P9 that Is In an 'on* state will 
execute this number of instructions. 

Default. If this parameter Is not speclfiedf then 
the 9? instruction count is Is set to an Infinite 
y al ue. 

display I ds This paraiaeter causes the Interpretive 
execution of the instructions of the designated P? 
to be displayed at the Interactive user*s terminal. 
If this parameter is specified as a keyword* le« 
display with no PP nu«iber» then the Instructions 
that are displayed are from the PP that was 
previously qualified by the QUALIFY.REFERENCE 
command* If a PP had not been previously qualified* 
then this cannot be specified as a keyword. This 
parameter Is only valid if the count parameter is 
al so spec! fled. 

Default. If this parameter (keyword) Is not 
specified then no P? instruction execution results 
are displayed. 

Examples: 

run.pp count»3000D 
run.PP c»10 display«3 
rp 10 display 
rp 5000 
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rp 15 5 

Sample output from RUN.PP with display«5 Csowe lines tryncated 
due to ERS line length) 

ION 07 IA)«000000/000007 

PSN 00 

UJN 20 

14H 13 (A)*000007 

iPML 2020,73 C73M0G17 <2037)«111023 C A)«000007/000 

SHN 76 CAJ«000003/000001 



05D 


4214 


05D 


4215 


05D 


4216J 


05D 


4236 


05D 


4237 


050 


4241 
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3»7.33 TRACE 



The purpose of the TRACE command is to set up the address 
Mfflits <pva»s) for the CPU trace. Instructions executed 
within the range of the specified timits are Interpreted with 
the results written to the Simulator trace file •SESSMTF*. 
The trace remains in effect until nuHifled by entering the 
REMOVE. TRACE coiRwand or unt 11 a subsequent TRACE comiaand is 
entered* Since only one CPU trace range may be acti¥e at any 
one tlpe» successive TRACE cosiifiands override any previous 
one* 

CPU trace I nfor luat Ion may be Interspersed with PP trace 
information If the PP trace is also active* 



trace I i«l ts«<star t.pva* «end.pva> 

Cexchange«<exchange_deslgnator>3 

limits t is This parameter specifies the limits or range 
of pva^s of CPU instructions to be traced* Ring 
numbers need not be entered as part of the PVA* 
They are Ignored if entered and ignored when testing 
If the P-reglster is within the limits* 

exchange I exct This parameter specifies an exchange 
package which Is to be used to ••qualify** the trace 
limits* Values accepted for this parameter are: 

I* exc* JOB This value Indicates that the trace 
limits apply only to any JOB exchange package* 

2* exc« MONITOR ? MON This value Indicates that the 
trace limits apply only to any MONITOR exchange 
package* 

3* exc« UNQUAL S UNO This value is only used to 
override any exchange parameter qualification 
in effect due to a previous QUAIIFY.REFERENCE 
command* When UNQUAL Is specif I edf any 
previous exchange oackage parameter 
qualification Is overridden* and the trace 
limits will apply to any exchange package * JOB 
or MONITOR. 

4* exc» <address> The real memory address (RMA) of 
an exchange package may be specified to 
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3,7.33 TRACE S T 



designate a particyiar exchange package 
ysed to qualify the trace Mdiits* 



to be 



Default* If the exciiange parameter is not entered 
for the command hut there is a current exchange 
parameter tiuai i f i cat i on due to a previous 
qual If y.ref erence comm^n^p then that value is used 
and Interpreted exactly as described above* 
Other>ilse# there Is no qualification and the trace 
limits i#lll apply to any exchange package - JQ8 or 
MONITOR. 

Ex amp I ess 

trace I i ml ts«80000^3f8 tl6)* .8000044b2<16) exc«Job 
trace }»100000000< 161 ••lOOOOf ff f <16) exchange«unQ 
t 0**0ff<16) job 
t Obl0100009000C 16 ) . • OblDlGOOOaOOOl 16 I 

Sample output from trace file SESSHTF? 



n 0000020A 
M 0000020C 
H 00000210 

n 0000021^ 



00001 F 80 
00001F84 
00001FB8 
OOOOIFBC 
OOOOIFCO 



OEOF 

A9FF0008 
B11F0020 
0200 

8E100078 
84350002 
82520005 
805F03CA 
9602fF8C 



CPYSX 
SHFX 

KEYPQINT 
EXCHANGE 

ADDAQ 

LA 

LX 

EMTE 

8RXGT 



XF-000000G06FFFFFEC 
XF«0000006FFFFFEC00 



RMA*00011400 0000100600000216 
A0«200800000078 
A5«200A00000100 
X2«00000000FFFFFFFF 
XF»00000000000003CA 
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3.7.3^ ^Si^^;;^i£i l^l^ 

3.7.34 TRACE.8ACK I T8 

The purpose of the TRACE. BACK cofnuiand is to display 

infonuation relevant to stack frames associated with an 

Interrupted procedure and its predecessor procedures. 

InforiBation displayed for eacti selected stack frame consists 
of: 

o Stack frafpe nunsber 

o Current p-address of the associated procedure 

o Virtual address of the start of the stack frame 

o Virtual address of the stack frawe save area 

A value of zero Is displayed In place of the stack frawe 
save area address for the exchange package. 

trace.back Cstack.fraaie«<fr a«e nuiber>1 
£repeat.count«<count>3 
Caddress*<pva>3 

Cexchange»<exchange_deslgnator>1 
Cdbug.f lle*<local file na«e>3 

stack.fr a«e • sf? This parameter specifies the nuinber of 
the first stack frame for which information is to be 
displayed. Stack frame number one Is associated 
nith the interrupted procedure (the exchange 
package) or with the stack frame associated with the 
address parameter* if specified. Stack frame two Is 
associated with the first stack frame procedure's 
predecessor* etc. The valid range for this 
parameter Is 1 .. 999. 

Default. If the stack frame parameter Is not 
specified* then the first stack frame for which 
Information Is displayed will be the exchange 
package or the stack frame associated with the 
address parameter (if specified). 

repeat.count * res This parameter specifies the total 
number of stack frames for which information Is to 
be displayed. The valid range for this parameter Is 
I ., 999. If this value exceedes the number of 
stack frames* output will terminate with the last 
frame In the stack. 

Default. Information for one stack frame is 
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displayed* 

address * a? This parameter specifies the process virtual 
address CPVA) of a stack frame save area at which 
the trace back begins (stack fra»e number one). 
Ring numbers are optional and ignored if entered as 
part of a PVA. 

Default* If the address parameter is not specified* 
stack frame nurnber one is the interrupted procedure 
C the exchange package)* 

exchange J exc? This parameter specifies the 'fraae of 
reference* for the cowroand* le* it specifies to 
which exchange package this command applies or which 
exchange package is to be used for virtual address 
translation* Values accepted for this parameter 
ares 

1* exc* JOB This value sets the frame of reference 
for this command to be the current job exchange 
package as located by the contents of the Job 
Process State CJPS) register* 

2* exc« MONITOR ! MOM This value sets the frame of 
reference for this command to be the current 
monitor exchange package as located by the 
contents of the Monitor Process State (MPS) 
regl ster * 

3* exc* UNQUAL ? UNQ This value is used to override 
any exchange parameter qualification in effect 
due to a previous QUALIf Y.REFERENCE command* 
When UNQUAL Is given* the frame of reference 
for this command is the exchange package of the 
current mode as determined by the mode bit In 
the Status Summary CSS) register* If the 
current CPU mode is monitor* then the frame of 
reference is the monitor exchange package 
pointed to by the MPS* If the current mode Is 
Job f the exchange package pointed to by the 
JPS Is the frame of reference* 

4* exc« <address> The real memory address (RMA) of 

an exchange package may be specified to 

designate that exchange package as the frame of 
reference for this command* 
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Default* If the exchange paraaeter is not entered 
for the commnn^p then the frame of reference for the 
comffland is determined in one of tiio Mays* 

(II If a previous qyal If y.reference command had 
qualified the exchange paraweter for subsequent 
coiii!!iands» then that value Is used as the frnme 
of reference for this co»?nand* 

iZ) If the exchange parameter was not 
previously qualified by QUAtlFY.REFERENCE* then 
the frame of reference is determined from the 
current mode In the Status Suaisiiary CSS) 
register and Its corresponding process state 
register - MPS or JPS. 

dbug.flle S dfs This parameter specifies the name of the 
local file which contains the debug module address 
table produced by VEIINK. Values accepted for this 
parameter ares 

I* df- <locat file name> Any valid NOS file name Is 
accepted* This file name temporarily overrides 
any qualified dbug.f i leestabi Ished previously 
by a qua! If y^referenee command* 

2. df= UNQUAl 5 UNQ This value Is used to negate 
any dbug.file qualification in effect due to a 
previous QUALIFY. REFERENCE command* No module 
names and offsets appear in the displayed 
Information* 

Default* If the dbug.flle parameter Is not entered 
for the command* the dbug.flle name is determined in 
one of two ways J 

(1) If a previous qual i f y.r ef erence command 
had qualified the dbug.flle for subsequent 
commands* then that value Is used as the 
dbug.flle name for this command* 

C2) If the dbug.file name was not previously 
qualified by QUAIIFY.REFERENCE» the dbug.fHe 
remains unqualified* 

Examples^ 

trace. back sf«l rc«999 
trace. back rc«6 
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tb a»300000078C16l sf«2 rc«3 
tb exc«»on 
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3.7»35 TRANSLATE^PVA S 1? 

The purpose of the TRANSLATE. PVA comfiiand Is to translate a 
process virtual address <PVA) Into a CPU real weaory address* 

translate.pva address*<pva> Cexchan9e«<excNanie.desi gfiator>1 

address I a: Ttiis parameter specifies the process virtual 
address that Is to fee translated* Ring numbers are 
optional and Ignored if entered as part of a PVA* 

exchange 1 exes This parameter specifies the 'fraipe of 
reference* for the cowmandt le* it specifies to 
i#hlch exchange package this copwand applies or which 
exchange package is to be used for virtual address 
translation* Values accepted for this parameter 
ares 

1* exc« JOB This value sets the frame of reference 
for this command to be the current job exchange 
package as located by the contents of the Job 
Process State (JPS) register* 

2* exc« HQNITOR 5 MQN This value sets the fra!»e of 
reference for this comwand to be the current 
monitor exchange package as located by the 
contents of the Monitor Process State (MPS) 
register* 

3* exc» UNQUAl \ UNO This value is used to override 
any exchange par aaieter qual if Icat ion in effect 
due to a previous QUALIFY.REFERENCE co?nwand. 
When UNQUAL Is given* the fraaie of reference 
for this cofflffland Is the exchange package of the 
current mode as determined by the mode bit in 
the Status Summary (SS) register* If the 
current CPU mode Is monitor* then the frame of 
reference is the monitor exchange package 
pointed to by the MPS* If the current mode Is 
Job » the exchange package pointed to by the 
JPS Is the frame of reference* 

4* exc* <address> The real memory address CRMA) of 

an exchange package may be specified to 

designate that exchange package as the frame of 
reference for this command* 
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Default* If the exchange parameter is not entered 
for the commandf then the frame of reference for the 
copwand Is determined In one of ti#o ways? 

Cll If a previous qual If y.reference command had 
qualified the exchange parameter for subsequent 
commands* then that value Is used as the frame 
of reference for this command* 

(21 If the exchange parameter «as not 
previously qualified by QUALIFY.REFERENCE* then 
the frame of reference Is determined from the 
current mode In the Status Summary CSS) 
register and Its corresponding process state 
register - MPS or JPS* 

Examples: 

trans! ate.pva addr ess«100004f f f C 16) 
tr ansi ate^pva a«0acdb{16) 
tp 81010000fddda6) 

Sample output: 

transi ate.pva a«0e00001528C 16) 
RMA« 0002 3528 
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3.8 S££ai4L-IMlIIU£IIiti«£aaC£iSIMS 

This section explains any special Instruction processing 
done by the Sifsylator and any Instruction deviations from the 
hardware description presented In the CYBER ISO MIGDS. 

3.8«1 I/O INSTRUCTION 

Input or Output a message at CAjl plus Q ■*■ If mode per k* 
This Is a special CP instruction <op code ff) that Is defined 
as an uni mpl emented instruction for the hardware* hut Is 
processed by the Simulator as an I/O instruction (for»at J k 
Q)« The instruction gives the user a aieans of coniBiunlcat Ing 
with a siffutated 180 program fro» a t ifne-shar ing terminal or 
to and from files If running In batch fiiode* 

This Instruction transfers a field of bytes between the 
terminal and central memory* with the direction of the 
transfer determined by the k f leldt and the length of the 
transfer determined by the binary contents of the first byte 
in the field - the Variable Field Indicator <VLI). The VII is 
addressed be expanding the Q field to 32 bits by means of sign 
extension and then adding the results to the rightmost 32 bits 
of the PVA contained in the Aj register* The remaining bytes 
comprise the ASCII characters of the message. 

k«0« QutfiUt* The message In the byte field is displayed 
at the users terminal* 

k*l* OutfiMt^AQii^tiaii* The message is displayed at the 
terminal as above* but once completed the CR Is 
halted pending further Simulator commands* 

k»2. Ia£iit» The input message is solicited from the 
user* First the Simulator displays the three 
character prompt ENT followed by a question mark* 
The input message may now be entered and will be 
placed starting at the byte immediately following 
the VII byte* The actual length of the message 
entered Is placed Into the VLI byte* 

k«3* QutEMi-acaaat.aQli^iQfiyi The prompt message In the 
byte field Is displayed at the terminal followed by 
a question mark; then input is solicited from the 
user* This option allows the user to display his 
own prompt for Input* The 'ENT* prompt is not 
displayed as It is for the k*2 option. The message 
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string used for the prompt is tersiinated by a period 
C*l« The VLI for this option determines the length 
of the input message which is placed in the byte 
field in the saise wanner as the k»2 option* 



Abnoriaal conditions. If the VII byte is encountered by the 
Sifliulator as zero COI» then the diacinostic wiessage 'VLI INPUT 
ERROR* or «VLI OUTPUT ERROR* will be displayed at the 
terminal* In addition^ if the error occurs for input {k»Z\ 
then the external bit in the MCR will be set* 
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3«8,2 KEYPQINT INSTRUCTION 

The C? Keypoint instruction (op code 811 is simulated as 
described In the CYBER 180 MIGDS with the exception that no 
transmission is done to the PerforiPtnce Honltorina Facility 
IPMFI. This facility currently is not simulated. 

In place of this> the SlJBulator writes keypoint Inf oriaat Ion 
to the SESSHKF file* Each tiwe the appropriate keypoint 
conditions are wet for recording to the PMF> the foliOMlng 
CYBIL record is «piritten to SESSHKF# (The PHF keypoint request 
flag is assumed as always set* I 

TYPE 

zsBitpr t_ppf_record^type » Ckeypointl# 
zsmtpinf^p^f. record * RECORD 

CASE record. type? zsmtprt.pmf. record. type OF 
«keypolnt« 

keypoint. tiflie: •• 3FFFFFFil6)» 
keypoint.classJ •• OfC16l# 
keypoint.codes «• 0FFFFFFFFI16I # 
CASEND, 
RECENDJ 
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3«8«3 EXECUTE AIGQRITHH INSTRUCTION 

The CP Execute Algorlthw instruction Cop codes CO - C7) is 
utilized by the Simulator to ••escape" from noriaai CPU 
instruction simulation. Four types of escapes are defined for 
the SlMuiator *ihlch correspond to the four instruction op 
codes C^ - C7« The remaining op codes for this instruction 
(CO - C3I cause an uniinpl emented instruction condition as 
specified in the NI6DS* 

The four types of escapes ares 

C4 This will escape CPU Instruction simulation and 
initiate PP CIOU) Instruction simulation for all PPs 
in an ao state* Control will return only after a 
similar ?? "escape" instruction <see following 
section on the ?? Escape Instruction) Is 
encountered. If all PP's are af£* then this 
instruction will execute as a NO-OP. 

C5 This escapes to the Simulated NQS/VE Prograjn Manager 
Interface package. Control returns upon cotnpletlon 
of the simulated function. 

C6 This escapes to the Simulated HOS/VE I/O interfaces 
paclcage. Control returns upon completion of the 
simulated function* 

C7 Escapes to a Hardware Checkout System CHCS) physical 
I/O simulation module. Control returns when 
complete. 
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3.8,4 PP ESCAPE INSTRUCTION 

The ?? escape instruction Is used to escape frop PP 
instryction simulation and initiate CP instruction 
simulation* Control will return only after a corresponding CP 
escape instruction has been executed (see the above section on 
the Execute Algorithjn Instruction). If the CP is fl££f then 
this instruction executes as a NO-OP instruction* The 
instruction used for the escape Is defined as a PASS 
Instruction In the NIGDS* as foMoi«s5 

107707C8> 
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The following diagnostic messages may appear in response to 
Simulator coRifsands* Sotae messages such as the Slisufator 
banner are purely I nf or iaati ve« Others denote error conditions 
caused by incorrect command syntax* 

The aiessages described here are messages originating frots 
the Sifliulator and are identified by the prefix ** X SM 
followed by a number in the range of 6000 - 6999. The only 
messages within this range that are not described In this ERS 
fall in the 6350 - 6399 range. These are simulated NOS/VE 
procedures messages and are described in the ERS for Simulated 
NOS/VE Program Interfaces. The X in the prefix Is either an 
I> Vf E or F referring to a severity level of Inf ormati onal# 
Warningf Error or Fatal* 

Other messages outside the 6000 - 6999 range may also be 
encountered during a simulation run. These messages originate 
from supporting utilities which the Simul ator cal I s such as 
the System Command Language procedures* Message Generator* 
Command Processor* etc* No attempt is made to define these 
messages* as most should be self-explanatory and usually 
result from from syntactical errors* Users may refer to the 
the appropriate ERS for a definition of these messages* 

Other questions or problems concerning error conditions 
should be directed to the SES analyst* Curt Rupert 482-2583* 

6001 XXX COHHANO UNKNOWN 

The command Indicated by xxx is unknown to the 
Simulator* 

6002 INSUFFICIENT HEAP SPACE FOR xxx 

This message indicates that some unexpected 

condition has occurred which could not be processed 

due to lack of heap space* The particular condition 

Is specified by xxx* The user should contact the 

SES analyst if this error is encountered* 

6003 REGISTER 10 AND VALUE LISTS NOT EQUAL IN LENGTH 

This message occurs when the number of register 
values does not equal the number of register names 
in the register name list for the change.reglster or 
change.pp. register commands* 
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3.9 DIAGNOSTIC MESSAGES 



6004 CHECKPOINT FILE BAD* ENTER -BYE- 

This message follows SES.SIM180 If the restart 
parameter specifies a checkpoint file that is bad* 
The fife Is more than likely not a valid checkpoint 
file* and the yser wust enter bye to exit from the 
Slfflulatort as all commands viili fail* 

6005 SIM CONTROL INEO REINITIALIZED* REGS AND HEH LOADED 

This message Is displayed after a RESTART coiawand or 
after SES.SIM180 is entered where the restart 
parameter specifies a checkpoint file that has been 
outdated by new requirements on the current version 
of the Slwulator. This Is usually caused by new 
requirements for control information and tables that 
are saved at checkpoint tisie* Mewory and processor 
registers are loaded and unaffected* only internal 
siiBulator control inforaiatlon such as run counts* 
breakpoints* etc. are lost* 



6006 TERMINATED 

A terfplnaf Interrupt condition has teriainated the 
cofflfsand* 



6007 ERROR IN LOADING OVERLAY 

An operating system or hardware problem has 
prevented successful loading of a Simulator 
overlay* Notify development center support. 



6022 INVALID NAME EQR xxx PARAMETER 

The name quoted for the xxx parameter Is not an 
acceptable value* The user should double check the 
syntax of the command In question. 



6035 CPU INTERRUPTED AT P«xxx* STATE«yyy 

This informative message occurs when a terminal 
Interrupt condition is encountered during 
instruction simulation initiated by the run or 
run.pp commands* The user may enter any Simulator 
command at this point. The xxx is the address in 
the P register at the time of interruption* and yyy 
specifies the CP state at the time - MONITOR or 
JOB. 
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3.0 DESCRIPTION 

3.9 DIAGNOSTIC MESSAGES 



6036 PPxx INTERRUPTED AT P«yfy 

This ififorwatiys message occurs when a terminal 
interrupt condition is encountered during 
instruction sifi^ulatlon Initiated by the run or 
fun^PP copmands* The user fsay enter any Simulator 
cowasand at this point* The xx Is the nuf»ber of the 
9? <decl»at) Interrupted and yyy is the address at 
the tiroe of interruption. 



6048 INSUI=FICI£NT OR INCONSISTENT PARAMETERS SPECIFIED 

This message indicates that parameters or 
combination of parameters specified for the 
preceding command are in conflict with the correct 
syntax of the command. The user should double check 
the syntax of the command in question. 



6052 CY8ER 180 SIMULATOR Vxx LEV yyy IMIGDS REV z) 

This is the S imul ator banner message which indicates 
that the simulated enyironment has been established* 
and any Simulator command may now be entered. The 
XX Indicates the current version of the Simulator 
and is increased by 1 with each SES Release* The 
yyy is the current level which Is increased by 1 
with every new prerelease and SES Release of the 
Simulator* The z indicates the current hardware 
MIGOS Revision level with which the Simulator fully 
conforms. 



6101 BAD LOAD fILE DIRECTORY ON xxx 

The file indicated by xxx is not the correct format 
for the load.memory command. 



6102 NO BINARY TEXT ON xxx 

The load.nemory command or load^pp. memory command 
did not encounter any binary text on the file xxx. 



6103 CAN NOT LOAD MEMORY FROM xxx 

The ioad^memory command was unable to write 
information from file xxx Into simulated central 
memory. 



6105 BAD PP LOAD FILE DIRECTORY ON xxx 
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3.0 DESCRIPTION 

3.9 DIAGNOSTIC HESSAGES 



The file indicated by xxx Is not the correct format 
for the f oad.pp.menory coiaroand* 



6106 ?? BINARY TEXT ON xxx UNKNOWN 

The load.pp.meiROf y coainiand encountered an unknown 
foraiat on file mxx« 



6107 XXX IS MOT A ?P LOAD FILE 

The file xxx is not a valid forwat to be loaded by 
the load.pp.neiior y coiBsiand. 



6108 9? MEMORY OVERElOy* xxx 

File xxx contains an excess of binary text for 
loading into simulated ?? isemory* 



6200 EXPECTING HEX VALUE FOR xxx 

This message Indicates that an incorrect hexadecimal 
value *#as specified for the xxx paraieterf eg* an 
alpha other than a thru f was found in the value* 



6201 INVALID REGISTER NUMBER 

An Illegal register nufliber has been specified on the 
display. register^ change.reglster or 
display.iieiiory.lndif ect cotninand* User should 
recheck syntax of command in question* 



620A INVALID REGISTER NAME -xxx- 

The illegal register name xxx has been specified on 
the last coaiffland* The user should recheck the 
syntax of the coinmand in question* 



6205 REGISTER VALUE TOO LARGE 

A register value specified for the change. register 
or change.pp.register command is too large to fit 
into the quoted register* The user should check the 
hardware description of the register to determine 
its size* 



6206 INVALID NUMERIC SIZE FOR xxx PARAMETER 

The value entered for the xxx parameter for the last 
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command is too large for the parameter* The user 
should recheck the syntax of the coflRwand In 
question* 

6207 INVALID ASCII PARAMETER SIZE 

A value entered as an ASCII string for a register or 
memory field for the last command is too large* The 
user should recheck the syntax of the cowmand in 
question* 

6209 CYBER 180 ADDRESS TOO LARGE 

A value entered for a central isenaory address 
parameter for the last command was too large* User 
should recheck the current simulated memory 
configuration* 

6212 INVALID CY3ER 180 ADDRESS 

The central memory process virtual address CPVA) 
specified on the last command was not translatable 
to a real memory address* User must verify that the 
virtual address translation tables are set up 
correctly* ie* page and segment tables* 

6213 PAGE NOT IN REAL MEMORY 

The last command was submitted which required access 

to a CY8ER 180 memory page that could not be found 

In real memory* The user should recheck the entry 

of the command in question and validate any PVA 

parameter value* The Simulator does not perform any 

implicit memory pagingt and all PVA must translate 
to real memory* 

6214 ADDRESS SPECIFICATION ERROR 

The PVA specified on the previous command was 
Illegal because the sign bit (bit 32) In the byte 
number (BN) field within the PVA was found to be 
set* 

6217 CPU BREAKPOINT ENCOUNTERED AT P»xxx, STATE«yyy 

This informative message indicates that the CP 
breakpoint address previously entered by the 
breakpoint command* has been encountered* The P 
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register contents xxx for the state yyy at tfne tlwe 
of the halt is included in the message* Any valid 
Simulator command may be entered at this point. 

6218 CPU HALT AT P*xxx* STATE«yyy 

This informative i«essage Indicates that the CP 
Instruction siisulation has encountered a halt 
condition at the P register address specified by 
xxxf In the state Indicated by yyy (NOMITOR or 
JOBI* The user may enter any valid Simulator 
command at this point* 

62ao PPxx BREAKPOINT ENCOUNTERED AT P«yyy 

This Informative message occurs *#hen a previously 

entered ?? breakpoint address has been encountered* 
The ?? number in which the breakpoint occurred Is 

indicated by xx and the p-register address by yyy* 

Any valid Simulator command may be entered at this 
point* 

6221 ??xt HALT AT P«yyy 

This Informative message Indicates that the 99 
instruction simulation in the ?? numbered xx has 
encountered a halt condition at the P register 
address specified by yyy* Any valid Simulator 
command may be entered at this point* 

6222 INVALID VALUE FOR xxx PARAHETER 

The user quoted a value for the parameter Indicated 
by xxx that vias unacceptable to the command* The 
user should review the command syntax* 

6224 xxx - FILE NOT LOCAL 

The file indicated by xxx specified on the previous 
command must exist as a local file* The file should 
be ACQUIREd and the command reentered* 

6228 EXPECTING POSITIVE VALUE FOR xxx PARAMETER 

The value entered for the parameter indicated by xxx 
must be entered with a positive value* 
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6229 EXPECTING INTEGER VALUE FOR xxx PARAMETER 

The value entered for the paraiseter indicated by xxx 
for the last command ^as invalid and must be an 
integer* and not a nawe or string* 

6230 EXPECTING INTEGER OR STRING VAtUE FOR xxx PARAMETER 

The value entered for the parameter indicated by xxx 
for the last cowrBand was not an integer or character 
string* 

6231 DESCENDING RANGE QUOTED FOR xxx PARAMETER 

The range entered for the parameter indicated by xxx 

for the last command was entered in the rey/QTse 

order* and aiust be entered in as an ascending 
r ange* 

6232 <STRING> VALUE NOT ALLOWED FOR xxx PARAMETER 

The value entered for the parameter indicated xxx 
for the last coiaffland cannot be a string value* 

6233 DUPLICATE VALUE FOR -xxx- 

The paraRieter indicated by xxx was specified at 
least twice on the previous cofRmand* 

6234 ADDRESS RANGE CANNOT SPAN SEGMENTS 

The range of PVA's specified for the SPY option of 
the ON command must be within the same segment 
number* 

6301 ?P NOT IN CONFIGURATION 

The pp. number parameter value for the last command 
specified a ?P number that is not included in the 
simulated CY3ER 180 hardware system* The user 
should use the display. info command to determine the 
numbers of the PPs in the configuration* 

6302 ?? NUMBER NOT QUALIFIED - VALUE REQUIRED 

No value was quoted for the pp. number parameter for 
the last command* Also* there Is no current 
PP.number parameter ctual i f i cat i on* This parameter 
is only optional if it has been previously qualified 
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by the fliual If f ^reference cowwand* The user must 
either tiyalify the pp.nynber or enter It viJth each 
cofflsiahd* 

6303 AIL PP% ARE OFF 

The run.pp coinraan<J was entered *^ith aM the PPs in 
an off state* The user should use the on cowhand to 
turn on the ?Ps which are to be simulated* The 
disptajf.lfif o cowhand gives the on/off status of all 
the PPs. 

6304 CPU IS OFF 

The run command was entered with the CPU In an off 
state* The display. Info cowffland can be used to 
inspect the on/off status of the CP and the on 
coaiRiand can be used to turn It on for instruction 
simulation* 



6350 - 6399 

See the Simulated NQS/VE Program Interfaces ERS* 
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^ . 4£££!iail- A-=.a4i£L£.SiayUiaE.-a£iaiQia 



The fotloMing sample Siinulator sessions give sope 

representative examples of Sif«ulator command ysage* Some 

command output lines may be truncated due to line length 
limitations of this document* 



4.1 SAia£L£-i£SSI01i-.t-l 

This sample session is an example of a user Interested only 
In CPU simulation. Most of the CPU commands are included at 
least once in this example* The format of the trace output 
written to file SESSMTF as a result of this session is shown 
under the TRACE command description. 



/ses«siml8 

*♦ I SM 
t display. 

S£GHEHT« 

00004030 

00004040 

? help cha 

CHANSE^M 



CM FBA» 
? qualify. 
? change. m 
? display. 
SEGMENT* 
0G00403A 
? display. 

X8 

? change. r 

? 'define* 

? checkpoi 

? run 6 di 

M 000011 

M 000011 

M 000012 



rs«mtrck 
6052s CYBER 
memory fba* 

0003 
00241022 
00000012 
nge.memory 
EMORY FIRS 
REPE 
EXCH 

Pl» BC« P 
reference a 
emory fba«3 
memory fba* 

0003 
3456 
register x« 
* 0000 0000 
egister x«8 
tempckx' 
nt fn*tempc 
spl ay 

E8 80070011 
FC 8D080022 
00 0200 



180 SIMULATOR V6.5 LEV 127 (MIGOS REV S) 
300004030(16) rc»4 am«pva exc«job 



22200000 00003333 55550000 
00120000 00000000 02424200 



$ 



33 UU 
BB 



T.BYTE. ADDRESS* PI BYTE.COUNT* P2 

AT. COUNT* P3# MEMQRY.VALUE* P4 

ANGE* P5 ADDRESS. MODE* P6 

Z$ RC« P3# HV» P4# EXC* P5, AM* P6 

m»pva exc«job 

0000403a<16) mv«3456(16) bc*2 

30000403a(16) bc*2 



4V 



8 
0000 0000 
xv«33(16l 

kx 

ENTE 
ENTE 
EXCHANGE 



X7*0O00OO00DO0OO011 
X8«0000000000000022 

RMA*00000580 0000800000001202 .. 



J 00004000 9400006C BRXEQ 
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4.0 AP*>EHDIX A - SAHPIE SIMULATOR SESSIONS 

4.1 SAMPLE SESSION # 1 



i 00004008 94000062 BRXEQ 
4 0000419C 3053 SNTP 
trace I lrolts*100003000<16U 
breakpoint addlress«33c8C16) 
dlsplay^lnfo 

QUALIFIERS: AOORESS.MQOE* PVA 
EILE.NAME* UNQUAL 
LAST.CP«RUH.COUNT» 6 

LAST.PP^RUH.COUMT« 

CP.TIMING OFF 



X 3*0000000000000005 
100004fff 116) 



EXCHANGE^* JOB PP* UNQUAL 

08UG«FILE= UNQUAL 
TOTAL* 9006 
TOTAL* 



CONFIGURATIONS 

STATUS? 

BRKPT5REF XP 
ADDRSS 
REMAIN 

TRACE5REF XP 
LIMITS 



000 



001 
001 



CPU 

ON 

JOB 
0000 
9999 

4QB 
0000 
0000 



PPOO PPOl PP02 PP03 PP04 PP05 PP06 PP07 
OFF OFF OFF OFF OFF OFF OFF OFF 



33C8 



3000 
4FFF 



0000 



run 

♦♦ I SM 62172 CPU BREAKPOINT 
displ ay.exchange.package 
P«0000 BOOO 0000 33C8 

0000 

0000 

0000 

0000 

3338 

0000 

FFF5 



AT P«0000 BOOO 0000 33C8, STAT£«JOB 



0000 
0000 
3E10 
0000 



M0«*0000 
UTP«0000 
TP«BOOO 
OLP»0000 
STA»0000 
KC»0000 
PIT«FFFF 
KEF* 
MOFaOOOO 
displ ay^reglster s«Cssf jpsi 
SS»0000 0000 0000 00 
AO « 8002 0000 2718 
A2 * B002 0000 2718 
d ispi ay.peinory.i ndl rect s«jp 
ABSOLUTE 0000 

00003E60 0000 3000 0000 33C 
translate. pva a«200002718<16 
RMA* 0001 5418 
remove. trace 
r em ove.break point 
run 750 
displ ay.regi ster Cpfss) 

P«0000 BOOO 0000 52 
bye 
REVERT. END SIM180 



MCR'OOOO 

MM*FFFF 
MID* 

TE« 

0M«00 
STL*0000 

KM*0000 
CFF* 
PND* 

aaO»«3 exc*fflon 
08 



s aflR*rma 



8 

) exc«iRon 



UCR«0000 
UM«FFFF 
UVMID* 
LPI0«00 
DI»00 
LRN* F 
KCN* 
OCF* 
BC*0000 0000 



JPS*0000 3E60 
Al * B002 0000 2718 
A3 * B002 0000 2678 



80 



SS«0000 0000 0000 0008 
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4«0 APPENDIX A - SAHPiE SIHUiATQR SESSIONS 
4.2 SAHPIE SESSION # 2 



This enumphe shows a user Interested! only In two concurrent 
PP simulations and no CPU simulation. Host ?? oriented 
cofflfflands are used in the example* The format of the trace 
output written to SESSHTF Is shown under the PP.TRACE command 
descr Ipt Ion* 



/ses.slmlSO 

t* I SH 6052? CY3ER 180 SIMULATOR V6.5 LEV 127 CHIGDS REV SI 
t •acciulre>ppblnaf ppblnb' 

? load.pp. memory fn«pphlna pp«3 fwa«101C8> 
? change.pp. register pp*3 regs*p vals«260C8) 
? di spl ay^pp.regi ster pp«3 

03D P« 0260 A« 000000 
? qua! if y.r ef erence pp«3 

tchange.pp. memory » > fwa«3300C8 ) mv«5555<8) rc»10 
? di spl ay.pp.memory > » fwa»3300C 8) rc»13 

PP03 

3300 005555 005555 005555 005555 

3304 005555 005555 005555 005555 

3310 005555 005555 000000 000000 

3314 002203 RC 
t on pp*3 

? qual If y. reference pp«4 
? load_pp^memory#f f n«ppt>inb 
? pp.breakpoint pp«3 address«7710t8) f«l 
? pp_trace#f I imits«1000( 8).. 2000(81 
? on pp*4 
? display^info 

QUALIFIERS: AODRESS.MODE* RHA EXCHANGE* UNQUAL PP« 04D 
FILE^NAHE* UNQUAL DBUG.FILE* UNQUAL 



LAST.CP.RUN.COUNT* 




TOTAL» 









LAST.PP.RUN.COUNT' 




TOTAL* 









CP.TIMING OFF 












CONFIGURATIONS 


CPU 


PPOO PPOl PP02 


PP03 


PP04 


PP05 PP06 PP07 P 


STATUSJ 


ON 


OFF OFF OFF 


ON 


ON 


OFF OFF OFF 


BRKPTtAODRSS 






7710 






REHAIN 






1 






TRACEJLIfllTS 








1000 
2000 




help off 












OFF PP.NUMBER* PI 


CPU 


CP.TIMING SPY 








OFF PP« PI CP CT SPY 










off CPU 












qual if y_r ef erence \ 


9P=unqual 
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4.2 SAMPLE SESSION # 2 



? run.PP 100 

? remove. pp^trace 

? fUfl.PP 

** I SM 6220s PP03 BREAKPOINT ENCOUNTERED AT P«?710 
? remoye^pp.breakpojnt pp«3 
t checkpoint fn^savelt 
? bye 

REVERT. END SIMISO 
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5. A££EMQiX-a.=.S4B£L£-S£X-Qyi£yi 



TNe following Is a sample **SPY** output (see on and off 
commskn^s) for a CPU run of 10000 I r^struct ions with SPY linits 
»0a0D000001000(16) «• Ob00000002000C 16) and nn exctiange 
designator exc-JOB. 

Counts for the various range "bins" are only incremented 
*ihen the P-reglster matches the exchange designator - In this 
case JQ8. This explains the difference between the total run 
count and the total sample countf I.e.* 2774 Instructions in 
MONi tor mode* 



The actual SPY output is formatted 
columns 50 - 114 were deleted to fit It 
approximately 90 lines were deleted 
short* 



for a wide printer* so 

Into this ERS. Also* 

to keep it somewhat 



P REGISTER SAHPLES FOR SEGHENT 00A# 8Y 



SAMPLES SELOy RANGE 
SAHPLES IN RANGE 
SA?1PL£S ABOVE RANGE 

TOTAL SAHPLES 



00000160 
00001850 
00005216 

00007226 



BYTE OFFSET. 



0.00 



10,00 

•f 



20.00 

+ 



BELOy 

00001000 

OOOOIOIC 

00001038 

00001054 

00001070 

G000108C 

000010A8 

000010C4 

OOOOIOEO 

OOOOIOFC 



00001000 
OOOOIOIB 
00001037 
00001053 
0000106F 
0000108B 
000010A7 
000010C3 
OOOOIODF 
OOOOIOFB 
00001117 



♦ ♦ 



100.00 




■»• 






00000160 




00000000 




00000000 




00000000 




00000000 




00000000 




00000000 




00000000 




00000000 




00000000 




00000002 
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00001118 


« 


00001133 






00000008 


00001134 


- 


00001141= 






00000007 


00001150 


- 


0000116B 






00000008 


0000116C 


— 


00001187 






00000007 


00001188 


- 


000D11A3 






00000008 


000011A4 


- 


0000118F 






00000007 


OOOOllCO 


« 


00001108 






00000007 


OOOOllDC 


- 


000011F7 






00000007 


000011F8 


- 


00001213 






00000008 


00001214 


- 


0000122F 






00000005 


00001230 


— 


00001248 






00000005 


0000124C 


- 


00001267 






00000007 


00001268 


- 


00001283 






00000009 


00001284 


- 


000ai29F 


!♦♦♦ • • J 




00000272 


00001 2A0 


- 


0000128B 


I**** • • * S 




00000360 


000012BC 


- 


00001207 


I*** • • ? 




00000258 


00001208 


- 


000012F3 


I*** . • J ' 




00000234 


000012F4 


- 


0000130F 






00000056 


00001310 


- 


0000132B 


I* • • J ' 




00000096 


00001 32C 


- 


00001347 






00000008 


00001348 


- 


00001363 






00000008 


00001364 


t im < 


0000137F 




wmmrmmmmmtMmi* 


00000010 



OOOOIEOO 


- 


OOOOIEIB 




OOOOIEIC 


- 


00001E37 




00001E38 


- 


00001E53 




00001E54 


- 


00001E6F 




00001E70 


- 


00001E8B 




00001 E8C 


- 


000D1EA7 




00001EA8 


- 


00001EC3 




00001EC4 


- 


OOOOIEOF 




OOOOIEEO 


- 


OOOOIEFB 




OOOOIEFC 


- 


00001F17 




00001F18 


- 


00001F33 




00001F34 


- 


00001F4F 




00001 F50 


- 


00001F68 




00001F6C 


- 


00001F87 




00001F88 


~ 


00001FA3 




00001FA4 


- 


OOOOIFBF 




OOOOIFCO 


- 


00001FD8 




OOOOIFOC 


- 


00001FF7 




00001FF8 


- 


00002000 




ABOVE 




00002000 


I* 









• 00 



ltt**t**^i^**^i^t***i^***il'***t 



4- 

10.00 




•I 00000000 

.1 OOOOOGOO 

♦I 00000000 

.1 00000000 

•I 00000000 

.1 00000000 

.1 00000000 

•I 00000000 

•I 00000000 

•I 00000000 

.1 00000000 

.1 00000000 

.1 00000000 

•I 00000000 

.1 00000000 

•I 00000000 

.1 00000000 

•I 00000000 

•I 00000000 

.1 00005216 



4- 

100,00 
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